home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1996 August / Software of the Month Club 1996 August.iso / pc / dos / dtp / fractint / fractint.doc < prev    next >
Encoding:
Text File  |  1996-06-19  |  479.8 KB  |  10,529 lines

  1.  
  2.                       Fractint Version 19.2                         Page 1
  3.  
  4.         New Features in Version 19.2...........................4
  5.         Introduction...........................................9
  6.  
  7.   1.    Fractint Commands.....................................11
  8.   1.1     Getting Started.....................................11
  9.   1.2     Plotting Commands...................................11
  10.   1.3     Zoom box Commands...................................14
  11.   1.4     Color Cycling Commands..............................16
  12.   1.5     Palette Editing Commands............................18
  13.   1.6     Image Save/Restore Commands.........................22
  14.   1.7     Print Command.......................................22
  15.   1.8     Parameter Save/Restore Commands.....................23
  16.   1.9     "3D" Commands.......................................25
  17.   1.10    Interrupting and Resuming...........................25
  18.   1.11    Orbits Window.......................................26
  19.   1.12    View Window.........................................26
  20.   1.13    Video Mode Function Keys............................28
  21.   1.14    Browse Commands.....................................28
  22.   1.15    RDS Commands........................................30
  23.   1.16    Hints...............................................30
  24.   1.17    Fractint on Unix....................................31
  25.   2.    Fractal Types.........................................33
  26.   2.1     The Mandelbrot Set..................................33
  27.   2.2     Julia Sets..........................................34
  28.   2.3     Julia Toggle Spacebar Commands......................35
  29.   2.4     Inverse Julias......................................36
  30.   2.5     Newton domains of attraction........................37
  31.   2.6     Newton..............................................38
  32.   2.7     Complex Newton......................................38
  33.   2.8     Lambda Sets.........................................39
  34.   2.9     Mandellambda Sets...................................39
  35.   2.10    Circle..............................................40
  36.   2.11    Plasma Clouds.......................................40
  37.   2.12    Lambdafn............................................41
  38.   2.13    Mandelfn............................................42
  39.   2.14    Barnsley Mandelbrot/Julia Sets......................42
  40.   2.15    Barnsley IFS Fractals...............................43
  41.   2.16    Sierpinski Gasket...................................44
  42.   2.17    Quartic Mandelbrot/Julia............................45
  43.   2.18    Distance Estimator..................................45
  44.   2.19    Pickover Mandelbrot/Julia Types.....................45
  45.   2.20    Pickover Popcorn....................................46
  46.   2.21    Peterson Variations.................................46
  47.   2.22    Unity...............................................47
  48.   2.23    Scott Taylor / Lee Skinner Variations...............47
  49.   2.24    Kam Torus...........................................48
  50.   2.25    Bifurcation.........................................48
  51.   2.26    Orbit Fractals......................................50
  52.   2.27    Lorenz Attractors...................................51
  53.   2.28    Rossler Attractors..................................52
  54.   2.29    Henon Attractors....................................52
  55.   2.30    Pickover Attractors.................................53
  56.   2.31    Gingerbreadman......................................53
  57.   2.32    Martin Attractors...................................53
  58.   2.33    Icon................................................54
  59.   2.34    Test................................................54
  60.  
  61.                       Fractint Version 19.2                         Page 2
  62.  
  63.   2.35    Formula.............................................55
  64.   2.36    Julibrots...........................................57
  65.   2.37    Diffusion Limited Aggregation.......................58
  66.   2.38    Magnetic Fractals...................................59
  67.   2.39    L-Systems...........................................60
  68.   2.40    Lyapunov Fractals...................................62
  69.   2.41    fn||fn Fractals.....................................63
  70.   2.42    Halley..............................................63
  71.   2.43    Dynamic System......................................64
  72.   2.44    Mandelcloud.........................................65
  73.   2.45    Quaternion..........................................65
  74.   2.46    HyperComplex........................................66
  75.   2.47    Cellular Automata...................................66
  76.   2.48    Ant Automaton.......................................67
  77.   2.49    Phoenix.............................................68
  78.   2.50    Frothy Basins.......................................69
  79.  
  80.   3.    Doodads, Bells, and Whistles..........................71
  81.   3.1     Drawing Method......................................71
  82.   3.2     Palette Maps........................................72
  83.   3.3     Autokey Mode........................................72
  84.   3.4     Distance Estimator Method...........................74
  85.   3.5     Inversion...........................................76
  86.   3.6     Decomposition.......................................76
  87.   3.7     Logarithmic Palettes and Color Ranges...............77
  88.   3.8     Biomorphs...........................................78
  89.   3.9     Continuous Potential................................79
  90.   3.10    Starfields..........................................81
  91.   3.11    Bailout Test........................................81
  92.   3.12    Random Dot Stereograms (RDS)........................82
  93.  
  94.   4.    "3D" Images...........................................85
  95.   4.1     3D Mode Selection...................................85
  96.   4.2     Select Fill Type Screen.............................88
  97.   4.3     Stereo 3D Viewing...................................89
  98.   4.4     Rectangular Coordinate Transformation...............90
  99.   4.5     3D Color Parameters.................................91
  100.   4.6     Light Source Parameters.............................92
  101.   4.7     Spherical Projection................................93
  102.   4.8     3D Overlay Mode.....................................93
  103.   4.9     Special Note for CGA or Hercules Users..............94
  104.   4.10    Making Terrains.....................................94
  105.   4.11    Making 3D Slides....................................96
  106.   4.12    Interfacing with Ray Tracing Programs...............96
  107.  
  108.   5.    Command Line Parameters, Parameter Files, Batch Mode..99
  109.   5.1     Using the DOS Command Line..........................99
  110.   5.2     Setting Defaults (SSTOOLS.INI File).................99
  111.   5.3     Parameter Files and the <@> Command................100
  112.   5.4     General Parameter Syntax...........................101
  113.   5.5     Startup Parameters.................................101
  114.   5.6     Calculation Mode Parameters........................103
  115.   5.7     Fractal Type Parameters............................103
  116.   5.8     Image Calculation Parameters.......................104
  117.   5.9     Color Parameters...................................106
  118.   5.10    Doodad Parameters..................................109
  119.  
  120.                       Fractint Version 19.2                         Page 3
  121.  
  122.   5.11    File Parameters....................................110
  123.   5.12    Video Parameters...................................111
  124.   5.13    Sound Parameters...................................113
  125.   5.14    Printer Parameters.................................114
  126.   5.15    PostScript Parameters..............................115
  127.   5.16    PaintJet Parameters................................117
  128.   5.17    Plotter Parameters.................................118
  129.   5.18    3D Parameters......................................118
  130.   5.19    Batch Mode.........................................120
  131.   5.20    Browser Parameters.................................121
  132.  
  133.   6.    Hardware Support.....................................123
  134.   6.1     Notes on Video Modes, "Standard" and Otherwise.....123
  135.   6.2     "Disk-Video" Modes.................................125
  136.   6.3     Customized Video Modes, FRACTINT.CFG...............126
  137.  
  138.   7.    Common Problems......................................129
  139.  
  140.   8.    Fractals and the PC..................................132
  141.   8.1     A Little History...................................132
  142.   8.1.1     Before Mandelbrot................................132
  143.   8.1.2     Who Is This Guy, Anyway?.........................133
  144.   8.2     A Little Code......................................134
  145.   8.2.1     Periodicity Logic................................134
  146.   8.2.2     Limitations of Integer Math (And How We Cope)....134
  147.   8.2.3     Arbitrary Precision and Deep Zooming.............135
  148.   8.2.4     The Fractint "Fractal Engine" Architecture.......137
  149.  
  150.   Appendix A Mathematics of the Fractal Types................139
  151.  
  152.   Appendix B Stone Soup With Pixels: The Authors.............158
  153.  
  154.   Appendix C GIF Save File Format............................166
  155.  
  156.   Appendix D Other Fractal Products..........................167
  157.  
  158.   Appendix E Bibliography....................................169
  159.  
  160.   Appendix F Other Programs..................................171
  161.  
  162.   Appendix G Revision History................................172
  163.  
  164.   Appendix H Version13 to Version 14 Type Mapping............190
  165.  
  166.                       Fractint Version 19.2                         Page 4
  167.  
  168.  New Features in Version 19.2
  169.  
  170.   Version 19.2 is a bug-fix release for version 19.1. Changes from 19.1 to
  171.     19.2 include:
  172.  
  173.   Fixed the 3D function, which was broken in 19.1 due to a side-effect of
  174.     a repair of a minor bug in 19.0. Arrgghh! This is the main reason for
  175.     the release of this version so quickly.
  176.  
  177.   Fixed a bug that caused the Julia inverse window and the orbits window
  178.     to lose their place after loading a color map.
  179.  
  180.   Fixed a bug that causes corners to be lost when too many digits are
  181.   entered.
  182.  
  183.   Added an enhanced ants automaton by Luciano Genero and Fulvio Cappelli.
  184.  
  185.   New showorbit command allows orbits-during-generation feature to be
  186.     turned on by default. Expanded limits of Hertz command to 20 to 15000.
  187.  
  188.   Targa 3D files are now correctly written to workdir rather than tempdir.
  189.  
  190.   Uncommented garbage between file entries is now ignored. (But note that
  191.     "{" must be on same line as entry name.)
  192.  
  193.   Fixed savename update logic.
  194.  
  195.   Version 19.1 is a bug-fix release for version 19.0. Changes from 19.0 to
  196.     19.1 include:
  197.  
  198.   Disabled the F6 (corners) key when in the parameters screen (<z>) for
  199.     arbitrary precision.
  200.  
  201.   IFS formulas now show in <z> screen.
  202.  
  203.   Allow RDS image maps of arbitrary dimensions.
  204.  
  205.   Touched up Mandelbrot/Julia <Space> toggle logic.
  206.  
  207.   Fractint now remembers map name, and uses the mapfile path correctly,
  208.     and now allows periods in directory names.
  209.  
  210.   Fixed tab bug that caused problems when interrupting a restore of an
  211.     arbitrary precision image.
  212.  
  213.   Repaired savename logic. No longer show (usually truncated) full path of
  214.     the saved file in the screen.
  215.  
  216.   Fixed double to arbitrary precision transition with 90 degree images.
  217.     (This only failed before when the image was rotated exactly 90
  218.     degrees.)
  219.  
  220.   Corrected docs directory errors that reported several commands such as
  221.     PARDIR= that were not implemented. Documented the color cycling HOME
  222.     function.
  223.  
  224.                       Fractint Version 19.2                         Page 5
  225.  
  226.   Fixed Mandelbrot/Julia types with bailout less than 4 (try it, results
  227.     are interesting!)
  228.  
  229.   Fixed browser delete feature which left a box on the screen after
  230.     deleting and exiting browser feature.
  231.  
  232.   More changes in filename processing logic.  ".\" is now recognized as
  233.     the current directory and is expanded to its full path name.  It is
  234.     now possible, although not recommended, to designate the root
  235.     directory of a disk as the desired search directory.
  236.  
  237.   Fixed integer math Mandelbrot bug for 286 or lower machines.
  238.  
  239.   Fixed problem of reading some Lsys files incorrectly (distribution
  240.     PENROSE.L file was broken unless first line was commented.)
  241.  
  242.   Fixed problem that caused endless loop in RDS with bad input values.
  243.  
  244.   Made reading the current directory first optional, added the new
  245.     curdir=yes command for times when you want to use current directory
  246.     files.
  247.  
  248.   Fixed problem with complexpower() function ("x^y" formula operator) in
  249.     the case where x == 0. (Note that formulas where 0^0 appears for every
  250.     every pixel are considered broken and no promises made.)
  251.  
  252.   Prevented aspect ratio drift as you zoom. If you want to make tiny
  253.     adjustments, use new ASPECTDRIFT=0 command.
  254.  
  255.   Inside=bof60 and bof61 options now work correctly with the formula
  256.   parser.
  257.  
  258.   We discovered the calculation time is no good after 24 days, so instead
  259.     of the time you will now get the message "A Really Long Time!!! (>
  260.     24.855 days)".  We thought you'd like to know ... A prize for the
  261.     first person who actually *sees* this message!
  262.  
  263.   A summary of features new with 19.0 begins on next page.
  264.  
  265.                       Fractint Version 19.2                         Page 6
  266.  
  267.   New arbitrary precision math allows types mandelbrot, julia, manzpower,
  268.     and julzpower to zoom to 10^1600. See Arbitrary Precision and Deep
  269.     Zooming (p. 135)
  270.  
  271.   New Random Dot Stereogram feature using <Ctrl>-<S>. Thanks to Paul De
  272.     Leeuw for contributing this feature. For more, see Random Dot
  273.     Stereograms (RDS) (p. 82).
  274.  
  275.   New browser invoked by the <l> command allows you to see the
  276.     relationships of a family of images within the current corners values.
  277.     See Browse Commands (p. 28) and Browser Parameters (p. 121). Thanks
  278.     to Robin Bussell for contributing this feature.
  279.  
  280.   Added four Bailout Test (p. 81)s, real, imag, or, and.  These are set
  281.     on the <Z> screen of the fractal types for which they work.  The
  282.     default is still mod.
  283.  
  284.   New asin, asinh, acos, acosh, atan, atanh, sqrt, abs (abs(x)+i*abs(y)),
  285.     and cabs (sqrt(x*x + y*y)) functions added to function variables and
  286.     parser.
  287.  
  288.   New fractal types types chip, quadruptwo, threeply, phoenixcplx,
  289.     mandphoenixclx, and ant automaton.
  290.  
  291.   Increased maximum iterations to 2,147,483,647 and maximum bailout to
  292.      2,100,000,000 when using floating point math.
  293.  
  294.   New path/directory management. Fractint now remembers the pathname of
  295.     command-line filenames. This means that you can specifiy directories
  296.     where your files reside in SSTOOLS.INI. In what follows, <path> can be
  297.     a directory, a filename, or a full path.
  298.  
  299.     File                      SSTOOLS.INI Command       Comments
  300.  
  301.     ==========================================================================
  302.     PAR directory             parmfile=<path>
  303.     GIF files for reading     filename=<path>
  304.     MAP files                 map=<path>
  305.     Autokey files             autokeyname=<path>
  306.     GIF files for saving      savename=<path>
  307.     Print file                printfile=<path>
  308.     Formula files             formulafile=<path>
  309.     Lsystem file              lfile=<path>
  310.     IFS file                  ifsfile=<path>
  311.     Miscellaneous files       workdir=<path>           new command
  312.     Temporary files           tempdir=<path>           new command
  313.  
  314.     If the directories do not exist, Fractint gives an error message on
  315.     runup with the option to continue.
  316.  
  317.                       Fractint Version 19.2                         Page 7
  318.  
  319.   Fractint now searches all FRM, IFS, LSYS, and PAR files in the
  320.     designated directory for entries. The number of entries in files has
  321.     been greatly increased from 200 to 2000. Comment support in these
  322.     files is improved.
  323.  
  324.   Parameters shown in <z> screen now match those used in a formula.
  325.  
  326.   Distance estimator logic has been overhauled, with the variable
  327.     olddemmcolors added for backward compatibility.
  328.  
  329.   New floating point code for Lsystems from Nick Wilt greatly speeds up
  330.      image generation.
  331.  
  332.   Enhanced fast parser from Chuck Ebbert makes floating point formula
  333.     fractals faster than built-in types.
  334.  
  335.   Enhanced the history command to include all parameters, colors, and even
  336.     .frm, .l, and .ifs file names and entries. Number of history sets
  337.     remembered can be set with the maxhistory=<nnn> command to save
  338.     memory.
  339.  
  340.   Enhanced center-mag coordinates to support rotated/stretched/skewed zoom
  341.     boxes.
  342.  
  343.   Added new parameter to built-in Halley for comparison with formula type,
  344.     also added new parameter to Frothybasin type.
  345.  
  346.   Added color number to orbits numbers <n> display.
  347.  
  348.   Added two new parameters to distest= to allow specifying resolution.
  349.     This allows making resolution-independent distance estimator images.
  350.  
  351.   Fixed bug that caused the "big red switch" bug if '(' appeared in random
  352.     uncommented formula file text, but fair warning, we don't officially
  353.     support uncommented text in FRM files.
  354.  
  355.   Symmetry now works for the Marksjulia type and Marksmandel types.
  356.  
  357.   Full path no longer written in PAR files with <b> command.
  358.  
  359.   Fixed fractal type fn(z*z) so that zooming out will no longer dump you
  360.     out to DOS, affecting zoomed out integer images made with this type.
  361.  
  362.   Fixed a float to fudged integer conversion that affects integer fractal
  363.     types fn(z*z) and fn*fn.  This has only a minor impact on integer
  364.     images made with these types.
  365.  
  366.   Default drive and directory restored after dropping to DOS, in case you
  367.     changed it while under DOS.
  368.  
  369.   Added support for inversion to the formula parser (type=formula).
  370.  
  371.   Increased maximum number of files listed by <r> command to 2977 from
  372.   300.
  373.  
  374.                       Fractint Version 19.2                         Page 8
  375.  
  376.   Added outside=atan option.
  377.  
  378.   Added faster auto logmap logic.
  379.  
  380.  
  381.                       Fractint Version 19.2                         Page 9
  382.  
  383.  Introduction
  384.  
  385.   FRACTINT plots and manipulates images of "objects" -- actually, sets of
  386.   mathematical points -- that have fractal dimension.  See "Fractals and
  387.   the PC" (p. 132) for some historical and mathematical background on
  388.   fractal geometry, a discipline named and popularized by mathematician
  389.   Benoit Mandelbrot. For now, these sets of points have three important
  390.   properties:
  391.  
  392.   1) They are generated by relatively simple calculations repeated over
  393.   and over, feeding the results of each step back into the next --
  394.   something computers can do very rapidly.
  395.  
  396.   2) They are, quite literally, infinitely complex: they reveal more and
  397.   more detail without limit as you plot smaller and smaller areas.
  398.   Fractint lets you "zoom in" by positioning a small box and hitting
  399.   <Enter> to redraw the boxed area at full-screen size; its maximum linear
  400.   "magnification" is over a trillionfold.
  401.  
  402.   3) They can be astonishingly beautiful, especially using PC color
  403.   displays' ability to assign colors to selected points, and (with VGA
  404.   displays or EGA in 640x350x16 mode) to "animate" the images by quickly
  405.   shifting those color assignments.
  406.  
  407.   For a demonstration of some of Fractint's features, run the
  408.   demonstration file included with this release (DEMO.BAT) by typing
  409.   "demo" at the DOS prompt. You can stop the demonstration at any time by
  410.   pressing <Esc>.
  411.  
  412.   The name FRACTINT was chosen because the program generates many of its
  413.   images using INTeger math, rather than the floating point calculations
  414.   used by most such programs. That means that you don't need a math co-
  415.   processor chip (aka floating point unit or FPU), although for a few
  416.   fractal types where floating point math is faster, the program
  417.   recognizes and automatically uses an 80x87 chip if it's present. It's
  418.   even faster on systems using Intel's 80386 and 80486 microprocessors,
  419.   where the integer math can be executed in their native 32-bit mode.
  420.  
  421.   Fractint works with many adapters and graphics modes from CGA to the
  422.   1024x768, 256-color XGA mode. Even "larger" images, up to 2048x2048x256,
  423.   can be plotted to expanded memory, extended memory, or disk: this
  424.   bypasses the screen and allows you to create images with higher
  425.   resolution than your current display can handle, and to run in
  426.   "background" under multi-tasking control programs such as DESQview and
  427.   Windows 3.
  428.  
  429.   Fractint is an experiment in collaboration. Many volunteers have joined
  430.   Bert Tyler, the program's first author, in improving successive
  431.   versions.  Through electronic mail messages, CompuServe's GO GRAPHICS
  432.   forums, new versions are hacked out and debugged a little at a time.
  433.   Fractint was born fast, and none of us has seen any other fractal
  434.   plotter close to the present version for speed, versatility, and all-
  435.   around wonderfulness. (If you have, tell us so we can steal somebody
  436.   else's ideas instead of each other's.)  See The Stone Soup Story
  437.   (p. 158) and A Word About the Authors (p. 159) for information about the
  438.   authors, and see Contacting the Authors (p. 161) for how to contribute
  439.  
  440.                       Fractint Version 19.2                        Page 10
  441.  
  442.   your own ideas and code.
  443.  
  444.   Fractint is freeware. The copyright is retained by the Stone Soup Group.
  445.  
  446.   Fractint may be freely copied and distributed in unmodified form but may
  447.   not be sold. (A nominal distribution fee may be charged for media and
  448.   handling by freeware and shareware distributors.) Fractint may be used
  449.   personally or in a business - if you can do your job better by using
  450.   Fractint, or using images from it, that's great! It may not be given
  451.   away with commercial products without explicit permission from the Stone
  452.   Soup Group.
  453.  
  454.   There is no warranty of Fractint's suitability for any purpose, nor any
  455.   acceptance of liability, express or implied.
  456.  
  457.    **********************************************************************
  458.    * Contribution policy: Don't want money. Got money. Want admiration. *
  459.    **********************************************************************
  460.  
  461.   Source code for Fractint is also freely available - see Distribution of
  462.   Fractint (p. 160).  See the FRACTSRC.DOC file included with the source
  463.   for conditions on use.  (In most cases we just want credit.)
  464.  
  465.                       Fractint Version 19.2                        Page 11
  466.  
  467.  1. Fractint Commands
  468.  
  469.  
  470.  1.1 Getting Started
  471.  
  472.   To start the program, enter FRACTINT at the DOS prompt. The program
  473.   displays an initial "credits" screen. If Fractint doesn't start
  474.   properly, please see Common Problems (p. 129).
  475.  
  476.   Hitting <Enter> gets you from the initial screen to the main menu. You
  477.   can select options from the menu by moving the highlight with the cursor
  478.   arrow keys and pressing <Enter>, or you can enter commands directly.
  479.  
  480.   As soon as you select a video mode, Fractint begins drawing an image -
  481.   the "full" Mandelbrot set if you haven't selected another fractal type.
  482.  
  483.   For a quick start, after starting Fractint try one of the following:
  484.     If you have MCGA, VGA, or better:  <F3>
  485.     If you have EGA:                   <F9>
  486.     If you have CGA:                   <F5>
  487.     Otherwise, monochrome:             <F6>
  488.  
  489.   After the initial Mandelbrot image has been displayed, try zooming into
  490.   it (see Zoom Box Commands (p. 14)) and color cycling (see Color Cycling
  491.   Commands (p. 16)).  Once you're comfortable with these basics, start
  492.   exploring other functions from the main menu.
  493.  
  494.   Help is available from the menu and at most other points in Fractint by
  495.   pressing the <F1> key.
  496.  
  497.   AT ANY TIME, you can hit a command key to select a function. You do not
  498.   need to wait for a calculation to finish, nor do you have to return to
  499.   the main menu.
  500.  
  501.   When entering commands, note that for the "typewriter" keys, upper and
  502.   lower case are equivalent, e.g. <B> and <b> have the same result.
  503.  
  504.   Many commands and parameters can be passed to FRACTINT as command-line
  505.   arguments or read from a configuration file; see "Command Line
  506.   Parameters, Parameter Files, Batch Mode" for details.
  507.  
  508.  
  509.  1.2 Plotting Commands
  510.  
  511.   Function keys & various combinations are used to select a video mode and
  512.   redraw the screen.  For a quick start try one of the following:
  513.     If you have MCGA, VGA, or better:  <F3>
  514.     If you have EGA:                   <F9>
  515.     If you have CGA:                   <F5>
  516.     Otherwise, monochrome:             <F6>
  517.  
  518.   <F1>
  519.   Display a help screen. The function keys available in help mode are
  520.   displayed at the bottom of the help screen.
  521.  
  522.                       Fractint Version 19.2                        Page 12
  523.  
  524.   <M> or <Esc>
  525.   Return from a displayed image to the main menu.
  526.  
  527.   <Esc>
  528.   From the main menu, <Esc> is used to exit from Fractint.
  529.  
  530.   <Delete>
  531.   Same as choosing "select video mode" from the main menu.  Goes to the
  532.   "select video mode" screen.  See Video Mode Function Keys (p. 28).
  533.  
  534.   <h>
  535.   Redraw the previous image in the circular history buffer, revisiting
  536.   fractals you previously generated this session in reverse order.
  537.   Fractint saves the last ten images worth of information including
  538.   fractal type, coordinates, colors, and all options. Image information is
  539.   saved only when some item changes. After ten images the circular buffer
  540.   wraps around and earlier information is overwritten. You can set image
  541.   capacity of the history feature using the maxhistory=<nnn> command.
  542.   About 1200 bytes of memory is required for each image slot.
  543.  
  544.   <Ctrl-h>
  545.   Redraw the next image in the circular history buffer. Use this to return
  546.   to images you passed by when using <h>.
  547.  
  548.   <Tab>
  549.   Display the current fractal type, parameters, video mode, screen or (if
  550.   displayed) zoom-box coordinates, maximum iteration count, and other
  551.   information useful in keeping track of where you are.  The Tab function
  552.   is non-destructive - if you press it while in the midst of generating an
  553.   image, you will continue generating it when you return.  The Tab
  554.   function tells you if your image is still being generated or has
  555.   finished - a handy feature for those overnight, 1024x768 resolution
  556.   fractal images.  If the image is incomplete, it also tells you whether
  557.   it can be interrupted and resumed.  (Any function other than <Tab> and
  558.   <F1> counts as an "interrupt".)
  559.  
  560.   The Tab screen also includes a pixel-counting function, which will count
  561.   the number of pixels colored in the inside color.  This gives an
  562.   estimate of the area of the fractal.  Note that the inside color must be
  563.   different from the outside color(s) for this to work; inside=0 is a good
  564.   choice.
  565.  
  566.   <T>
  567.   Select a fractal type. Move the cursor to your choice (or type the first
  568.   few letters of its name) and hit <Enter>. Next you will be prompted for
  569.   any parameters used by the selected type - hit <Enter> for the defaults.
  570.   See Fractal Types (p. 33) for a list of supported types.
  571.  
  572.   <F>
  573.   Toggles the use of floating-point algorithms (see "Limitations of
  574.   Integer Math (And How We Cope)" (p. 134)).  Whether floating point is in
  575.   use is shown on the <Tab> status screen.  The floating point option can
  576.   also be turned on and off using the "X" options screen.  If you have a
  577.   non-Intel floating point chip which supports the full 387 instruction
  578.   set, see the "FPU=" command in Startup Parameters (p. 101) to get the
  579.   most out of your chip.
  580.  
  581.                       Fractint Version 19.2                        Page 13
  582.  
  583.   <X>
  584.   Select a number of eXtended options. Brings up a full-screen menu of
  585.   options, any of which you can change at will.  These options are:
  586.     "passes=" - see Drawing Method (p. 71)
  587.     Floating point toggle - see <F> key description below
  588.     "maxiter=" - see Image Calculation Parameters (p. 104)
  589.     "inside=" and "outside=" - see Color Parameters (p. 106)
  590.     "savename=" filename - see File Parameters (p. 110)
  591.     "overwrite=" option - see File Parameters (p. 110)
  592.     "sound=" option - see Sound Parameters (p. 113)
  593.     "logmap=" - see Logarithmic Palettes and Color Ranges (p. 77)
  594.     "biomorph=" - see Biomorphs (p. 78)
  595.     "decomp=" - see Decomposition (p. 76)
  596.     "fillcolor=" - see Drawing Method (p. 71)
  597.  
  598.   <Y>
  599.   More options which we couldn't fit under the <X> command:
  600.     "finattract=" - see Finite Attractors (p. 152)
  601.     "potential=" parameters - see Continuous Potential (p. 79)
  602.     "invert=" parameters - see Inversion (p. 76)
  603.     "distest=" parameters - see Distance Estimator Method (p. 74)
  604.     "cyclerange=" - see Color Cycling Commands (p. 16)
  605.  
  606.   <Z>
  607.   Modify the parameters specific to the currently selected fractal type.
  608.   This command lets you modify the parameters which are requested when you
  609.   select a new fractal type with the <T> command, without having to repeat
  610.   that selection. You can enter "e" or "p" in column one of the input
  611.   fields to get the numbers e and pi (2.71828... and 3.14159...).
  612.   From the fractal parameters screen, you can press <F6> to bring up a sub
  613.   parameter screen for the coordinates of the image's corners.  With
  614.   selected fractal types, <Z> allows you to change the Bailout Test
  615.   (p. 81).
  616.  
  617.   <+> or <->
  618.   Switch to color-cycling mode and begin cycling the palette by shifting
  619.   each color to the next "contour."  See Color Cycling Commands (p. 16).
  620.  
  621.   <C>
  622.   Switch to color-cycling mode but do not start cycling.  The normally
  623.   black "overscan" border of the screen changes to white.  See Color
  624.   Cycling Commands (p. 16).
  625.  
  626.   <E>
  627.   Enter Palette-Editing Mode.  See Palette Editing Commands (p. 18).
  628.  
  629.   <Spacebar>
  630.   Toggle between Mandelbrot set images and their corresponding Julia-set
  631.   images. Read the notes in Fractal Types, Julia Sets (p. 34) before
  632.   trying this option if you want to see anything interesting.
  633.  
  634.   <J>
  635.   Toggle between Julia escape time fractal and the Inverse Julia orbit
  636.   fractal. See Inverse Julias (p. 36)
  637.  
  638.                       Fractint Version 19.2                        Page 14
  639.  
  640.   <Enter>
  641.   Enter is used to resume calculation after a pause. It is only necessary
  642.   to do this when there is a message on the screen waiting to be
  643.   acknowledged, such as the message shown after you save an image to disk.
  644.  
  645.   <I>
  646.   Modify 3D transformation parameters used with 3D fractal types such as
  647.   "Lorenz3D" and 3D "IFS" definitions, including the selection of "funny
  648.   glasses" (p. 89) red/blue 3D.
  649.  
  650.   <A>
  651.   Convert the current image into a fractal 'starfield'.  See Starfields
  652.   (p. 81).
  653.  
  654.   <Ctrl-A>
  655.   Unleash an image-eating ant automaton on current image. See Ant
  656.   Automaton (p. 67).
  657.  
  658.   <Ctrl-S> (or <k>)
  659.   Convert the current image into a Random Dot Stereogram (RDS).  See
  660.   Random Dot Stereograms (RDS) (p. 82).
  661.  
  662.   <O> (the letter, not the number)
  663.   If pressed while an image is being generated, toggles the display of
  664.   intermediate results -- the "orbits" Fractint uses as it calculates
  665.   values for each point. Slows the display a bit, but shows you how clever
  666.   the program is behind the scenes. (See "A Little Code" in "Fractals and
  667.   the PC" (p. 132).)
  668.  
  669.   <D>
  670.   Shell to DOS. Return to Fractint by entering "exit" at a DOS prompt.
  671.  
  672.   <Insert>
  673.   Restart at the "credits" screen and reset most variables to their
  674.   initial state.  Variables which are not reset are: savename, lightname,
  675.   video, startup filename.
  676.  
  677.   <L>
  678.   Enter Browsing Mode.  See Browse Commands (p. 28).
  679.  
  680.  
  681.  1.3 Zoom box Commands
  682.  
  683.   Zoom Box functions can be invoked while an image is being generated or
  684.   when it has been completely drawn.  Zooming is supported for most
  685.   fractal types, but not all.
  686.  
  687.   The general approach to using the zoom box is:  Frame an area using the
  688.   keys described below, then <Enter> to expand what's in the frame to fill
  689.   the whole screen (zoom in); or <Ctrl><Enter> to shrink the current image
  690.   into the framed area (zoom out). With a mouse, double-click the left
  691.   button to zoom in, double click the right button to zoom out.
  692.  
  693.   <Page Up>, <Page Down>
  694.   Use <Page Up> to initially bring up the zoom box. It starts at full
  695.   screen size. Subsequent use of these keys makes the zoom box smaller or
  696.  
  697.                       Fractint Version 19.2                        Page 15
  698.  
  699.   larger.  Using <Page Down> to enlarge the zoom box when it is already at
  700.   maximum size removes the zoom box from the display. Moving the mouse
  701.   away from you or toward you while holding the left button down performs
  702.   the same functions as these keys.
  703.  
  704.   Using the cursor "arrow" keys or moving the mouse without holding any
  705.   buttons down, moves the zoom box.
  706.  
  707.   Holding <Ctrl> while pressing cursor "arrow" keys moves the box 5 times
  708.   faster.  (This only works with enhanced keyboards.)
  709.  
  710.   Panning: If you move a fullsize zoombox and don't change anything else
  711.   before performing the zoom, Fractint just moves what's already on the
  712.   screen and then fills in the new edges, to reduce drawing time. This
  713.   feature applies to most fractal types but not all.  A side effect is
  714.   that while an image is incomplete, a full size zoom box moves in steps
  715.   larger than one pixel.  Fractint keeps the box on multiple pixel
  716.   boundaries, to make panning possible.  As a multi-pass (e.g. solid
  717.   guessing) image approaches completion, the zoom box can move in smaller
  718.   increments.
  719.  
  720.   In addition to resizing the zoom box and moving it around, you can do
  721.   some rather warped things with it.  If you're a new Fractint user, we
  722.   recommend skipping the rest of the zoom box functions for now and coming
  723.   back to them when you're comfortable with the basic zoom box functions.
  724.  
  725.   <Ctrl><Keypad->, <Ctrl><Keypad+>
  726.   Holding <Ctrl> and pressing the numeric keypad's + or - keys rotates the
  727.   zoom box. Moving the mouse left or right while holding the right button
  728.   down performs the same function.
  729.  
  730.   <Ctrl><Page Up>, <Ctrl><Page Down>
  731.   These commands change the zoom box's "aspect ratio", stretching or
  732.   shrinking it vertically. Moving the mouse away from you or toward you
  733.   while holding both buttons (or the middle button on a 3-button mouse)
  734.   down performs the same function. There are no commands to directly
  735.   stretch or shrink the zoom box horizontally - the same effect can be
  736.   achieved by combining vertical stretching and resizing.
  737.  
  738.   <Ctrl><Home>, <Ctrl><End>
  739.   These commands "skew" the zoom box, moving the top and bottom edges in
  740.   opposite directions. Moving the mouse left or right while holding both
  741.   buttons (or the middle button on a 3-button mouse) down performs the
  742.   same function. There are no commands to directly skew the left and right
  743.   edges - the same effect can be achieved by using these functions
  744.   combined with rotation.
  745.  
  746.   <Ctrl><Insert>, <Ctrl><Delete>
  747.   These commands change the zoom box color. This is useful when you're
  748.   having trouble seeing the zoom box against the colors around it. Moving
  749.   the mouse away from you or toward you while holding the right button
  750.   down performs the same function.
  751.  
  752.   You may find it difficult to figure out what combination of size,
  753.   position rotation, stretch, and skew to use to get a particular result.
  754.   (We do.)
  755.  
  756.                       Fractint Version 19.2                        Page 16
  757.  
  758.   A good way to get a feel for all these functions is to play with the
  759.   Gingerbreadman fractal type. Gingerbreadman's shape makes it easy to see
  760.   what you're doing to him. A warning though: Gingerbreadman will run
  761.   forever, he's never quite done! So, pre-empt with your next zoom when
  762.   he's baked enough.
  763.  
  764.   If you accidentally change your zoom box shape or rotate and forget
  765.   which way is up, just use <PageDown> to make it bigger until it
  766.   disappears, then <PageUp> to get a fresh one.  With a mouse, after
  767.   removing the old zoom box from the display release and re-press the left
  768.   button for a fresh one.
  769.  
  770.   If your screen does not have a 4:3 "aspect ratio" (i.e. if the visible
  771.   display area on it is not 1.333 times as wide as it is high), rotating
  772.   and zooming will have some odd effects - angles will change, including
  773.   the zoom box's shape itself, circles (if you are so lucky as to see any
  774.   with a non-standard aspect ratio) become non-circular, and so on. The
  775.   vast majority of PC screens *do* have a 4:3 aspect ratio.
  776.  
  777.   Zooming is not implemented for the plasma and diffusion fractal types,
  778.   nor for overlayed and 3D images. A few fractal types support zooming but
  779.   do not support rotation and skewing - nothing happens when you try it.
  780.  
  781.  
  782.  1.4 Color Cycling Commands
  783.  
  784.   Color-cycling mode is entered with the 'c', '+', or '-' keys from an
  785.   image, or with the 'c' key from Palette-Editing mode.
  786.  
  787.   The color-cycling commands are available ONLY for VGA adapters and EGA
  788.   adapters in 640x350x16 mode.  You can also enter color-cycling while
  789.   using a disk-video mode, to load or save a palette - other functions are
  790.   not supported in disk-video.
  791.  
  792.   Note that the colors available on an EGA adapter (16 colors at a time
  793.   out of a palette of 64) are limited compared to those of VGA, super-VGA,
  794.   and MCGA (16 or 256 colors at a time out of a palette of 262,144). So
  795.   color-cycling in general looks a LOT better in the latter modes. Also,
  796.   because of the EGA palette restrictions, some commands are not available
  797.   with EGA adapters.
  798.  
  799.   Color cycling applies to the color numbers selected by the "cyclerange="
  800.   command line parameter (also changeable via the <Y> options screen and
  801.   via the palette editor).  By default, color numbers 1 to 255 inclusive
  802.   are cycled.  On some images you might want to set "inside=0" (<X>
  803.   options or command line parameter) to exclude the "lake" from color
  804.   cycling.
  805.  
  806.   When you are in color-cycling mode, you will either see the screen
  807.   colors cycling, or will see a white "overscan" border when paused, as a
  808.   reminder that you are still in this mode.  The keyboard commands
  809.   available once you've entered color-cycling. are described below.
  810.  
  811.   <F1>
  812.   Bring up a HELP screen with commands specific to color cycling mode.
  813.  
  814.                       Fractint Version 19.2                        Page 17
  815.  
  816.   <Esc>
  817.   Leave color-cycling mode.
  818.  
  819.   <Home>
  820.   Restore original palette.
  821.  
  822.   <+> or <->
  823.   Begin cycling the palette by shifting each color to the next "contour."
  824.   <+> cycles the colors in one direction, <-> in the other.
  825.  
  826.   '<' or '>'
  827.   Force a color-cycling pause, disable random colorizing, and single-step
  828.   through a one color-cycle.  For "fine-tuning" your image colors.
  829.  
  830.   Cursor up/down
  831.   Increase/decrease the cycling speed. High speeds may cause a harmless
  832.   flicker at the top of the screen.
  833.  
  834.   <F2> through <F10>
  835.   Switches from simple rotation to color selection using randomly
  836.   generated color bands of short (F2) to long (F10) duration.
  837.  
  838.   <1> through <9>
  839.   Causes the screen to be updated every 'n' color cycles (the default is
  840.   1).  Handy for slower computers.
  841.  
  842.   <Enter>
  843.   Randomly selects a function key (F2 through F10) and then updates ALL
  844.   the screen colors prior to displaying them for instant, random colors.
  845.   Hit this over and over again (we do).
  846.  
  847.   <Spacebar>
  848.   Pause cycling with white overscan area. Cycling restarts with any
  849.   command key (including another spacebar).
  850.  
  851.   <Shift><F1>-<F10>
  852.   Pause cycling and reset the palette to a preset two color "straight"
  853.   assignment, such as a spread from black to white. (Not for EGA)
  854.  
  855.   <Ctrl><F1>-<F10>
  856.   Pause & set a 2-color cyclical assignment, e.g. red->yellow->red (not
  857.   EGA).
  858.  
  859.   <Alt><F1>-<F10>
  860.   Pause & set a 3-color cyclical assignment, e.g. green->white->blue (not
  861.   EGA).
  862.  
  863.   <R>, <G>, <B>
  864.   Pause and increase the red, green, or blue component of all colors by a
  865.   small amount (not for EGA). Note the case distinction of this vs:
  866.  
  867.   <r>, <g>, <b>
  868.   Pause and decrease the red, green, or blue component of all colors by a
  869.   small amount (not for EGA).
  870.  
  871.                       Fractint Version 19.2                        Page 18
  872.  
  873.   <D> or <A>
  874.   Pause and load an external color map from the files DEFAULT.MAP or
  875.   ALTERN.MAP, supplied with the program.
  876.  
  877.   <L>
  878.   Pause and load an external color map (.MAP file).  Several .MAP files
  879.   are supplied with Fractint.  See Palette Maps (p. 72).
  880.  
  881.   <S>
  882.   Pause, prompt for a filename, and save the current palette to the named
  883.   file (.MAP assumed).  See Palette Maps (p. 72).
  884.  
  885.  
  886.  1.5 Palette Editing Commands
  887.  
  888.   Palette-editing mode provides a number of tools for modifying the colors
  889.   in an image.  It can be used only with MCGA or higher adapters, and only
  890.   with 16 or 256 color video modes.  Many thanks to Ethan Nagel for
  891.   creating the palette editor.
  892.  
  893.   Use the <E> key to enter palette-editing mode from a displayed image or
  894.   from the main menu.
  895.  
  896.   When this mode is entered, an empty palette frame is displayed. You can
  897.   use the cursor keys to position the frame outline, and <Pageup> and
  898.   <Pagedn> to change its size.  (The upper and lower limits on the size
  899.   depend on the current video mode.)  When the frame is positioned where
  900.   you want it, hit Enter to display the current palette in the frame.
  901.  
  902.   Note that the palette frame shows R(ed) G(reen) and B(lue) values for
  903.   two color registers at the top.  The active color register has a solid
  904.   frame, the inactive register's frame is dotted.  Within the active
  905.   register, the active color component is framed.
  906.  
  907.   Using the commands described below, you can assign particular colors to
  908.   the registers and manipulate them.  Note that at any given time there
  909.   are two colors "X"d - these are pre-empted by the editor to display the
  910.   palette frame. They can be edited but the results won't be visible. You
  911.   can change which two colors are borrowed ("X"d out) by using the <v>
  912.   command.
  913.  
  914.   Once the palette frame is displayed and filled in, the following
  915.   commands are available:
  916.  
  917.   <F1>
  918.   Bring up a HELP screen with commands specific to palette-editing mode.
  919.  
  920.   <Esc>
  921.   Leave palette-editing mode
  922.  
  923.   <H>
  924.   Hide the palette frame to see full image; the cross-hair remains visible
  925.   and all functions remain enabled; hit <H> again to restore the palette
  926.   display.
  927.  
  928.                       Fractint Version 19.2                        Page 19
  929.  
  930.   Cursor keys
  931.   Move the cross-hair cursor around. In 'auto' mode (the default) the
  932.   color under the center of the cross-hair is automatically assigned to
  933.   the active color register. Control-Cursor keys move the cross-hair
  934.   faster. A mouse can also be used to move around.
  935.  
  936.   <R> <G> <B>
  937.   Select the Red, Green, or Blue component of the active color register
  938.   for subsequent commands
  939.  
  940.   <Insert> <Delete>
  941.   Select previous or next color component in active register
  942.  
  943.   <+> <->
  944.   Increase or decrease the active color component value by 1  Numeric
  945.   keypad (gray) + and - keys do the same.
  946.  
  947.   <Pageup> <Pagedn>
  948.   Increase or decrease the active color component value by 5; Moving the
  949.   mouse up/down with left button held is the same
  950.  
  951.   <0> <1> <2> <3> <4> <5>
  952.   Set the active color component's value to 0 10 20 ... 60
  953.  
  954.   <Space>
  955.   Select the other color register as the active one.  In the default
  956.   'auto' mode this results in the now-inactive register being set to
  957.   remember the color under the cursor, and the now-active register
  958.   changing from whatever it had previously remembered to now follow the
  959.   color.
  960.  
  961.   <,> <.>
  962.   Rotate the palette one step.  By default colors 1 through 255 inclusive
  963.   are rotated.  This range can be over-ridden with the "cyclerange"
  964.   parameter, the <Y> options screen, or the <O> command described below.
  965.  
  966.   "<" ">"
  967.   Rotate the palette continuously (until next keystroke)
  968.  
  969.   <O>
  970.   Set the color cycling range to the range of colors currently defined by
  971.   the color registers.
  972.  
  973.   <C>
  974.   Enter Color-Cycling Mode.  When you invoke color-cycling from here, it
  975.   will subsequently return to palette-editing when you <Esc> from it.  See
  976.   Color Cycling Commands (p. 16).
  977.  
  978.   <=>
  979.   Create a smoothly shaded range of colors between the colors selected by
  980.   the two color registers.
  981.  
  982.   <M>
  983.   Specify a gamma value for the shading created by <=>.
  984.  
  985.                       Fractint Version 19.2                        Page 20
  986.  
  987.   <D>
  988.   Duplicate the inactive color register's values to the active color
  989.   register.
  990.  
  991.   <T>
  992.   Stripe-shade - create a smoothly shaded range of colors between the two
  993.   color registers, setting only every Nth register.  After hitting <T>,
  994.   hit a numeric key from 2 to 9 to specify N.  For example, if you press
  995.   <T> <3>, smooth shading is done between the two color registers,
  996.   affecting only every 3rd color between them.  The other colors between
  997.   them remain unchanged.
  998.  
  999.   <W>
  1000.   Convert current palette to gray-scale.  (If the <X> or <Y> exclude
  1001.   ranges described later are in force, only the active range of colors is
  1002.   converted to gray-scale.)
  1003.  
  1004.   <Shift-F2> ... <Shift-F9>
  1005.   Store the current palette in a temporary save area associated with the
  1006.   function key.  The temporary save palettes are useful for quickly
  1007.   comparing different palettes or the effect of some changes - see next
  1008.   command.  The temporary palettes are only remembered until you exit from
  1009.   palette-editing mode.
  1010.  
  1011.   <F2> ... <F9>
  1012.   Restore the palette from a temporary save area.  If you haven't
  1013.   previously saved a palette for the function key, you'll get a simple
  1014.   grey scale.
  1015.  
  1016.   <L>
  1017.   Pause and load an external color map (.MAP file).  See Palette Maps
  1018.   (p. 72).
  1019.  
  1020.   <S>
  1021.   Pause, prompt for a filename, and save the current palette to the named
  1022.   file (.MAP assumed).  See Palette Maps (p. 72).
  1023.  
  1024.   <I>
  1025.   Invert frame colors.  With some colors the palette is easier to see when
  1026.   the frame colors are interchanged.
  1027.   <\>
  1028.   Move or resize the palette frame.  The frame outline is drawn - it can
  1029.   then be repositioned and sized with the cursor keys, <Pageup> and
  1030.   <Pagedn>, just as was done when first entering palette-editing mode.
  1031.   Hit Enter when done moving/sizing.
  1032.  
  1033.   <V>
  1034.   Use the colors currently selected by the two color registers for the
  1035.   palette editor's frame.  When palette editing mode is entered, the last
  1036.   two colors are "X"d out for use by the palette editor; this command can
  1037.   be used to replace the default with two other color numbers.
  1038.  
  1039.   <A>
  1040.   Toggle 'auto' mode on or off.  When on (the default), the active color
  1041.   register follows the cursor; when off, <Enter> must be pressed to set
  1042.   the active register to the color under the cursor.
  1043.  
  1044.                       Fractint Version 19.2                        Page 21
  1045.  
  1046.   <Enter>
  1047.   Only useful when 'auto' is off, as described above; double clicking the
  1048.   left mouse button is the same as Enter.
  1049.  
  1050.   <X>
  1051.   Toggle 'exclude' mode on or off - when toggled on, only those image
  1052.   pixels which match the active color are displayed.
  1053.  
  1054.   <Y>
  1055.   Toggle 'exclude' range on or off - similar to <X>, but all pixels
  1056.   matching colors in the range of the two color registers are displayed.
  1057.  
  1058.   <N>
  1059.   Make a negative color palette - will convert only current color if in
  1060.   'x' mode or range between editors in 'y' mode or entire palette if in
  1061.   "normal" mode.
  1062.  
  1063.   <!>
  1064.   <@>
  1065.   <#>
  1066.   Swap R<->G, G<->B, and R<->B columns. These keys are shifted 1, 2, and
  1067.   3, which you may find easier to remember.
  1068.  
  1069.   <U>
  1070.   Undoes the last palette editor command.  Will undo all the way to the
  1071.   beginning of the current session.
  1072.   <E> Redoes the undone palette editor commands.
  1073.  
  1074.   <F>
  1075.   Toggles "Freestyle mode" on and off (Freestyle mode changes a range of
  1076.   palette values smoothly from a center value outward).  With your cursor
  1077.   inside the palette box, press the <F> key to enter Freestyle mode.  A
  1078.   default range of colors will be selected for you centered at the cursor
  1079.   (the ends of the color range are noted by putting dashed lines around
  1080.   the corresponding palette values). While in Freestyle mode:
  1081.  
  1082.    Moving the mouse changes the location of the range of colors that are
  1083.    affected.
  1084.  
  1085.    Control-Insert/Delete or the shifted-right-mouse-button changes the
  1086.    size of the affected palette range.
  1087.  
  1088.    The normal color editing keys (R,G,B,1-6, etc) set the central color of
  1089.    the affected palette range.
  1090.    Pressing ENTER or double-clicking the left mouse button makes the
  1091.    palette changes permanent (if you don't perform this step, any palette
  1092.    changes disappear when you press the <F> key again to exit freestyle
  1093.    mode).
  1094.  
  1095.                       Fractint Version 19.2                        Page 22
  1096.  
  1097.  1.6 Image Save/Restore Commands
  1098.  
  1099.   <S> saves the current image to disk. All parameters required to recreate
  1100.   the image are saved with it. Progress is marked by colored lines moving
  1101.   down the screen's edges.
  1102.  
  1103.   The default filename for the first image saved after starting Fractint
  1104.   is FRACT001.GIF;  subsequent saves in the same session are automatically
  1105.   incremented 002, 003... Use the "savename=" parameter or <X> options
  1106.   screen to change the name. By default, files left over from previous
  1107.   sessions are not overwritten - the first unused FRACTnnn name is used.
  1108.   Use the "overwrite=yes" parameter or <X> options screen) to overwrite
  1109.   existing files.
  1110.  
  1111.   A save operation can be interrupted by pressing any key. If you
  1112.   interrupt, you'll be asked whether to keep or discard the partial file.
  1113.  
  1114.   <R> restores an image previously saved with <S>, or an ordinary GIF
  1115.   file.  After pressing <R> you are shown the file names in the current
  1116.   directory which match the current file mask. To select a file to
  1117.   restore, move the cursor to it (or type the first few letters of its
  1118.   name) and press <Enter>.
  1119.  
  1120.   Directories are shown in the file list with a "\" at the end of the
  1121.   name.  When you select a directory, the contents of that directory are
  1122.   shown. Or, you can type the name of a different directory (and
  1123.   optionally a different drive) and press <Enter> for a new display. You
  1124.   can also type a mask such as "*.XYZ" and press <Enter> to display files
  1125.   whose name ends with the matching suffix (XYZ).
  1126.  
  1127.   You can use <F6> to switch directories to the default fractint directory
  1128.   or to your own directory which is specified through the DOS environment
  1129.   variable "FRACTDIR".
  1130.  
  1131.   Once you have selected a file to restore, a summary description of the
  1132.   file is shown, with a video mode selection list. Usually you can just
  1133.   press <Enter> to go past this screen and load the image. Other choices
  1134.   available at this point are:
  1135.     Cursor keys: select a different video mode
  1136.     <Tab>: display more information about the fractal
  1137.     <F1>: for help about the "err" column in displayed video modes
  1138.   If you restore a file into a video mode which does not have the same
  1139.   pixel dimensions as the file, Fractint will make some adjustments:  The
  1140.   view window parameters (see <V> command) will automatically be set to an
  1141.   appropriate size, and if the image is larger than the screen dimensions,
  1142.   it will be reduced by using only every Nth pixel during the restore.
  1143.  
  1144.  
  1145.  1.7 Print Command
  1146.  
  1147.   <P>
  1148.  
  1149.   Print the current fractal image on your (Laserjet, Paintjet, Epson-
  1150.   compatible, PostScript, or HP-GL) printer.
  1151.  
  1152.                       Fractint Version 19.2                        Page 23
  1153.  
  1154.   See "Setting Defaults (SSTOOLS.INI File)" (p. 99) and "Printer
  1155.   Parameters" (p. 114) for how to let Fractint know about your printer
  1156.   setup.
  1157.  
  1158.   "Disk-Video" Modes (p. 125) can be used to generate images for printing
  1159.   at higher resolutions than your screen supports.
  1160.  
  1161.  
  1162.  1.8 Parameter Save/Restore Commands
  1163.  
  1164.   Parameter files can be used to save/restore all options and settings
  1165.   required to recreate particular images.  The parameters required to
  1166.   describe an image require very little disk space, especially compared
  1167.   with saving the image itself.
  1168.  
  1169.   <@> or <2>
  1170.  
  1171.   The <@> or <2> command loads a set of parameters describing an image.
  1172.   (Actually, it can also be used to set non-image parameters such as
  1173.   SOUND, but at this point we're interested in images. Other uses of
  1174.   parameter files are discussed in "Parameter Files and the <@> Command"
  1175.   (p. 100).)
  1176.  
  1177.   When you hit <@> or <2>, Fractint displays the names of the entries in
  1178.   the currently selected parameter file.  The default parameter file,
  1179.   FRACTINT.PAR, is included with the Fractint release and contains
  1180.   parameters for some sample images.
  1181.  
  1182.   After pressing <@> or <2>, highlight an entry and press <Enter> to load
  1183.   it, or press <F6> to change to another parameter file.
  1184.  
  1185.   Note that parameter file entries specify all calculation related
  1186.   parameters, but do not specify things like the video mode - the image
  1187.   will be plotted in your currently selected mode.
  1188.  
  1189.   <B>
  1190.  
  1191.   The <B> command saves the parameters required to describe the currently
  1192.   displayed image, which can subsequently be used with the <@> or <2>
  1193.   command to recreate it.
  1194.  
  1195.   After you press <B>, Fractint prompts for:
  1196.  
  1197.     Parameter file:  The name of the file to store the parameters in.  You
  1198.     should use some name like "myimages" instead of fractint.par, so that
  1199.     your images are kept separate from the ones released with new versions
  1200.     of Fractint. You can use the PARMFILE= command in SSTOOLS.INI to set
  1201.     the default parameter file name to "myimages" or whatever.  (See
  1202.     "Setting Defaults (SSTOOLS.INI File)" (p. 99) and "parmfile=" in
  1203.     "File Parameters" (p. 110).)
  1204.  
  1205.     Name:  The name you want to assign to the entry, to be displayed when
  1206.     the <@> or <2> command is used.
  1207.  
  1208.                       Fractint Version 19.2                        Page 24
  1209.  
  1210.     Main comment:  A comment to be shown beside the entry in the <@>
  1211.     command display.
  1212.  
  1213.     Second, Third, and Fourth comment:  Additional comments to store in
  1214.     the file with the entry. These comments go in the file only, and are
  1215.     not displayed by the <@> command.
  1216.  
  1217.     Record colors?:  Whether color information should be included in the
  1218.     entry. Usually the default value displayed by Fractint is what you
  1219.     want.  Allowed values are:
  1220.     "no" - Don't record colors. This is the default if the image is using
  1221.        your video adapter's default colors.
  1222.     "@mapfilename" - When these parameters are used, load colors from the
  1223.        named color map file. This is the default if you are currently
  1224.        using colors from a color map file.
  1225.     "yes" - Record the colors in detail. This is the default when you've
  1226.        changed the display colors by using the palette editor or by color
  1227.        cycling. The only reason that this isn't what Fractint always does
  1228.        for the <B> command is that color information can be bulky - up to
  1229.        nearly 1K of disk space. That may not sound like much, but can add
  1230.        up when you consider the thousands of wonderful images you may find
  1231.        you just *have* to record...  Smooth-shaded ranges of colors are
  1232.        compressed, so if that's used a lot in an image the color
  1233.        information won't be as bulky.
  1234.  
  1235.     # of colors:  This only matters if "Record colors?" is set to "yes".
  1236.     It specifies the number of colors to record. Recording less colors
  1237.     will take less space. Usually the default value displayed by Fractint
  1238.     is what you want. You might want to increase it in some cases, e.g. if
  1239.     you are using a 256 color mode with maxiter 150, and have used the
  1240.     palette editor to set all 256 possible colors for use with color
  1241.     cycling, then you'll want to set the "# of colors" to 256.
  1242.  
  1243.     At the bottom of the input screen are inputs for Fractint's "pieces"
  1244.     divide-and-conquer feature. You can create multiple PAR entries that
  1245.     break an image up into pieces so that you can generate the image
  1246.     pieces one by one. There are two reasons for doing this. The first is
  1247.     in case the fractal is very slow, and you want to generate parts of
  1248.     the image at the same time on several computers. The second is that
  1249.     you might want to make an image greater than 2048 x 2048. The
  1250.     parameters for this feature are:
  1251.        X Multiples - How many divisions of final image in the x direction
  1252.        Y Multiples - How many divisions of final image in the y direction
  1253.        Video mode  - Fractint video mode for each piece (e.g. "F3")
  1254.  
  1255.     The last item defaults to the current video mode. If either X
  1256.     Multiples or Y Multiples are greater than 1, then multiple numbered
  1257.     PAR entries for the pieces are added to the PAR file, and a
  1258.     MAKEMIG.BAT file is created that builds all of the component pieces
  1259.     and then stitches them together into a "multi-image" GIF.  The current
  1260.     limitations of the "divide and conquer" algorithm are 36 or fewer X
  1261.     and Y multiples (so you are limited to "only" 36x36=1296 component
  1262.     images), and a final resolution limit in both the X and Y directions
  1263.     of 65,535 (a limitation of "only" four billion pixels or so).
  1264.  
  1265.                       Fractint Version 19.2                        Page 25
  1266.  
  1267.     The final image generated by MAKEMIG is a "multi-image" GIF file
  1268.     called FRACTMIG.GIF.  In case you have other software that can't
  1269.     handle multi-image GIF files, MAKEMIG includes a final (but commented
  1270.     out) call to SIMPLGIF, a companion program that reads a GIF file that
  1271.     may contain little tricks like multiple images and creates a simple
  1272.     GIF from it.  Fair warning: SIMPLGIF needs room to build a composite
  1273.     image while it works, and it does that using a temporary disk file
  1274.     equal to the size of the final image - and a 64Kx64K GIF image
  1275.     requires a 4GB temporary disk file!
  1276.  
  1277.   <G>
  1278.  
  1279.   The <G> command lets you give a startup parameter interactively.
  1280.  
  1281.  
  1282.  1.9 "3D" Commands
  1283.  
  1284.   See "3D" Images (p. 85) for details of these commands.
  1285.  
  1286.   <3>
  1287.   Restore a saved image as a 3D "landscape", translating its color
  1288.   information into "height". You will be prompted for all KINDS of
  1289.   options.
  1290.  
  1291.   <#>
  1292.   Restore in 3D and overlay the result on the current screen.
  1293.  
  1294.  
  1295.  1.10 Interrupting and Resuming
  1296.  
  1297.   Fractint command keys can be loosely grouped as:
  1298.  
  1299.    o Keys which suspend calculation of the current image (if one is being
  1300.      calculated) and automatically resume after the function.  <Tab>
  1301.      (display status information) and <F1> (display help), are the only
  1302.      keys in this group.
  1303.  
  1304.    o Keys which automatically trigger calculation of a new image.
  1305.      Examples:  selecting a video mode (e.g. <F3>);  selecting a fractal
  1306.      type using <T>;  using the <X> screen to change an option such as
  1307.      maximum iterations.
  1308.  
  1309.    o Keys which do something, then wait for you to indicate what to do
  1310.      next.  Examples:  <M> to go to main menu;  <C> to enter color cycling
  1311.      mode;  <PageUp> to bring up a zoom box.  After using a command in
  1312.      this group, calculation automatically resumes when you return from
  1313.      the function (e.g. <Esc> from color cycling, <PageDn> to clear zoom
  1314.      box).  There are a few fractal types which cannot resume calculation,
  1315.      they are noted below.  Note that after saving an image with <S>, you
  1316.      must press <Enter> to clear the "saved" message from the screen and
  1317.      resume.
  1318.  
  1319.   An image which is <S>aved before it completes can later be <R>estored
  1320.   and continued. The calculation is automatically resumed when you restore
  1321.   such an image.
  1322.  
  1323.                       Fractint Version 19.2                        Page 26
  1324.  
  1325.   When a slow fractal type resumes after an interruption in the third
  1326.   category above, there may be a lag while nothing visible happens.  This
  1327.   is because most cases of resume restart at the beginning of a screen
  1328.   line.  If unsure, you can check whether calculation has resumed with the
  1329.   <Tab> key.
  1330.  
  1331.   The following fractal types cannot (currently) be resumed: plasma, 3d
  1332.   transformations, julibrot, and 3d orbital types like lorenz3d.  To check
  1333.   whether resuming an image is possible, use the <Tab> key while it is
  1334.   calculating.  It is resumable unless there is a note under the fractal
  1335.   type saying it is not.
  1336.  
  1337.   The Batch Mode (p. 120) section discusses how to resume in batch mode.
  1338.  
  1339.   To <R>estore and resume a "formula", "lsystem", or "ifs" type fractal
  1340.   your "formulafile", "lfile", or "ifsfile" must contain the required
  1341.   name.
  1342.  
  1343.  
  1344.  1.11 Orbits Window
  1345.  
  1346.   The <O> key turns on the Orbit mode.  In this mode a cursor appears over
  1347.   the fractal. A window appears showing the orbit used in the calculation
  1348.   of the color at the point where the cursor is. Move the cursor around
  1349.   the fractal using the arrow keys or the mouse and watch the orbits
  1350.   change. Try entering the Orbits mode with View Windows (<V>) turned on.
  1351.   The following keys take effect in Orbits mode.
  1352.   <c>         Circle toggle - makes little circles with radii inversely
  1353.               proportional to the iteration. Press <c> again to toggle
  1354.               back to point-by-point display of orbits.
  1355.   <l>         Line toggle - connects orbits with lines (can use with <c>)
  1356.   <n>         Numbers toggle - shows complex coordinates and color number
  1357.   of
  1358.               the cursor on the screen. Press <n> again to turn off numbers.
  1359.   <p>         Enter pixel coordinates directly
  1360.   <h>         Hide fractal toggle. Works only if View Windows is turned on
  1361.               and set for a small window (such as the default size.) Hides the
  1362.               fractal, allowing the orbit to take up the whole screen. Press
  1363.               <h> again to uncover the fractal.
  1364.   <s>         Saves the fractal, cursor, orbits, and numbers as they
  1365.   appear
  1366.               on the screen.
  1367.   <<> or <,>  Zoom orbits image smaller
  1368.   <>> or <.>  Zoom orbits image larger
  1369.   <z>         Restore default zoom.
  1370.  
  1371.  
  1372.  1.12 View Window
  1373.  
  1374.   The <V> command is used to set the view window parameters described
  1375.   below.  These parameters can be used to:
  1376.    o Define a small window on the screen which is to contain the generated
  1377.      images. Using a small window speeds up calculation time (there are
  1378.      fewer pixels to generate). You can use a small window to explore
  1379.      quickly, then turn the view window off to recalculate the image at
  1380.      full screen size.
  1381.  
  1382.                       Fractint Version 19.2                        Page 27
  1383.  
  1384.    o Generate an image with a different "aspect ratio"; e.g. in a square
  1385.      window or in a tall skinny rectangle.
  1386.    o View saved GIF images which have pixel dimensions different from any
  1387.      mode supported by your hardware. This use of view windows occurs
  1388.      automatically when you restore such an image.
  1389.  
  1390.   "Preview display"
  1391.   Set this to "yes" to turn on view window, "no" for full screen display.
  1392.   While this is "no", the only view parameter which has any affect is
  1393.   "final media aspect ratio". When a view window is being used, all other
  1394.   Fractint functions continue to operate normally - you can zoom, color-
  1395.   cycle, and all the rest.
  1396.  
  1397.   "Reduction factor"
  1398.   When an explicit size is not given, this determines the view window
  1399.   size, as a factor of the screen size.  E.g. a reduction factor of 2
  1400.   makes the window 1/2 as big as the screen in both dimensions.
  1401.  
  1402.   "Final media aspect ratio"
  1403.   This is the height of the final image you want, divided by the width.
  1404.   The default is 0.75 because standard PC monitors have a height:width
  1405.   ratio of 3:4. E.g. set this to 2.0 for an image twice as high as it is
  1406.   wide. The effect of this parameter is visible only when "preview
  1407.   display" is enabled.
  1408.  
  1409.   "Crop starting coordinates"
  1410.   This parameter affects what happens when you change the aspect ratio. If
  1411.   set to "no", then when you change aspect ratio, the prior image will be
  1412.   squeezed or stretched to fit into the new shape. If set to "yes", the
  1413.   prior image is "cropped" to avoid squeezing or stretching.
  1414.  
  1415.   "Explicit size"
  1416.   Setting these to non-zero values over-rides the "reduction factor" with
  1417.   explicit sizes in pixels. If only the "x pixels" size is specified, the
  1418.   "y pixels" size is calculated automatically based on x and the aspect
  1419.   ratio.
  1420.  
  1421.   More about final aspect ratio:  If you want to produce a high quality
  1422.   hard-copy image which is say 8" high by 5" down, based on a vertical
  1423.   "slice" of an existing image, you could use a procedure like the
  1424.   following. You'll need some method of converting a GIF image to your
  1425.   final media (slide or whatever) - Fractint can only do the whole job
  1426.   with a PostScript printer, it does not preserve aspect ratio with other
  1427.   printers.
  1428.    o restore the existing image
  1429.    o set view parameters: preview to yes, reduction to anything (say 2),
  1430.      aspect ratio to 1.6, and crop to yes
  1431.    o zoom, rotate, whatever, till you get the desired final image
  1432.    o set preview display back to no
  1433.    o trigger final calculation in some high res disk video mode, using the
  1434.      appropriate video mode function key
  1435.    o print directly to a PostScript printer, or save the result as a GIF
  1436.      file and use external utilities to convert to hard copy.
  1437.  
  1438.                       Fractint Version 19.2                        Page 28
  1439.  
  1440.  1.13 Video Mode Function Keys
  1441.  
  1442.   Fractint supports *so* many video modes that we've given up trying to
  1443.   reserve a keyboard combination for each of them.
  1444.  
  1445.   Any supported video mode can be selected by going to the "Select Video
  1446.   Mode" screen (from main menu or by using <Delete>), then using the
  1447.   cursor up and down arrow keys and/or <PageUp> and <PageDown> keys to
  1448.   highlight the desired mode, then pressing <Enter>.
  1449.  
  1450.   Up to 39 modes can be assigned to the keys F2-F10, SF1-SF10
  1451.   <Shift>+<Fn>), CF1-CF10 (<Ctrl>+<Fn>), and AF1-AF10 (<Alt>+<Fn>).  The
  1452.   modes assigned to function keys can be invoked directly by pressing the
  1453.   assigned key, without going to the video mode selection screen.
  1454.  
  1455.   30 key combinations can be reassigned:  <F1> to <F10> combined with any
  1456.   of <Shift>, <Ctrl>, or <Alt>.  The video modes assigned to <F2> through
  1457.   <F10> can not be changed - these are assigned to the most common video
  1458.   modes, which might be used in demonstration files or batches.
  1459.  
  1460.   To reassign a function key to a mode you often use, go to the "select
  1461.   video mode" screen, highlight the video mode, press the keypad (gray)
  1462.   <+> key, then press the desired function key or key combination.  The
  1463.   new key assignment will be remembered for future runs.
  1464.  
  1465.   To unassign a key (so that it doesn't invoke any video mode), highlight
  1466.   the mode currently selected by the key and press the keypad (gray) <->
  1467.   key.
  1468.  
  1469.   A note about the "select video modes" screen: the video modes which are
  1470.   displayed with a 'B' suffix in the number of colors are modes which have
  1471.   no custom programming - they use the BIOS and are S-L-O-W ones.
  1472.  
  1473.   See "Video Adapter Notes" (p. 123) for comments about particular
  1474.   adapters.
  1475.  
  1476.   See "Disk-Video" Modes (p. 125) for a description of these non-display
  1477.   modes.
  1478.  
  1479.   See "Customized Video Modes, FRACTINT.CFG" (p. 126) for information
  1480.   about adding your own video modes.
  1481.  
  1482.  
  1483.  1.14 Browse Commands
  1484.  
  1485.   The following keystrokes function while browsing an image:
  1486.  
  1487.   <ARROW KEYS>     Step through the outlines on the screen.
  1488.   <ENTER>          Selects the image to display.
  1489.   <\>,<h>          Recalls the last image selected.
  1490.   <D>              Deletes the selected file.
  1491.   <R>              Renames the selected file.
  1492.   <s>              Saves the current image with the browser boxes
  1493.   displayed.
  1494.   <ESC>,<l>        Toggles the browse mode off.
  1495.   <Ctrl-b>         Brings up the Browser Parameters (p. 121) screen.
  1496.  
  1497.                       Fractint Version 19.2                        Page 29
  1498.  
  1499.   This is a "visual directory", here is how it works...
  1500.   When 'L' or 'l' is pressed from a fractal display the current directory
  1501.   is searched for any saved files that are deeper zooms of the current
  1502.   image and their position shown on screen by a box (or crosshairs if the
  1503.   box would be too small). See also Browser Parameters (p. 121) for more
  1504.   on how this is done.
  1505.  
  1506.   One outline flashes, the selected outline can be changed by using the
  1507.   cursor keys.  At the moment the outlines are selected in the order that
  1508.   they appear in your directory, so don't worry if the flashing window
  1509.   jumps all over the place!
  1510.   When enter is pressed, the selected image is loaded. In this mode a
  1511.   stack of the last sixteen selected filenames is maintained and the '\'
  1512.   or 'h' key pops and loads the last image you were looking at.  Using
  1513.   this it is possible to set up sequences of images that allow easy
  1514.   exploration of your favorite fractal without having to wait for recalc
  1515.   once the level of zoom gets too high, great for demos! (also useful for
  1516.   keeping track of just exactly where fract532.gif came from :-) )
  1517.  
  1518.   You can also use this facility to tidy up your disk: by typing UPPER
  1519.   CASE 'D' when a file is selected the browser will delete the file for
  1520.   you, after making sure that you really mean it, you must reply to the
  1521.   "are you sure" prompts with an UPPER CASE 'Y' and nothing else,
  1522.   otherwise the command is ignored. Just to make absolutely sure you don't
  1523.   accidentally wipe out the fruits of many hours of cpu time the default
  1524.   setting is to have the browser prompt you twice, you can disable the
  1525.   second prompt within the parameters screen, however, if you're feeling
  1526.   overconfident :-).
  1527.  
  1528.   To complement the Delete function there is a rename function, use the
  1529.   UPPER CASE 'R' key for this. You need to enter the FULL new file name,
  1530.   no .GIF is implied.
  1531.  
  1532.   It is possible to save the current image along with all of the displayed
  1533.   boxes indicating subimages by pressing the 's' key.  This exits the
  1534.   browse mode to save the image and the boxes become a permanent part of
  1535.   the image.  Currently, the screen image ends up with stray dots colored
  1536.   after it is saved.
  1537.  
  1538.   Esc backs out of image selecting mode.
  1539.  
  1540.   To find the next outer image, zoom in using page_up, press
  1541.   control_enter, ignore the generating image, and press control_L to start
  1542.   browsing.  Whatever is boxed around the center is the next outer image!
  1543.   POSSIBLE ERRORS:
  1544.  
  1545.   "Sorry..I can't find anything"
  1546.   The browser can't locate any files which match the file name mask.  See
  1547.   Browser Parameters (p. 121)  This is also displayed if you have less
  1548.   than 10K of far memory free when you run Fractint.
  1549.  
  1550.   "Sorry....  no more space"
  1551.   At the moment the browser can only cope with 450 sub images at one time.
  1552.   Any subsequent images are ignored, make sure that the minimum image size
  1553.   isn't set too small on the parameters screen.
  1554.  
  1555.                       Fractint Version 19.2                        Page 30
  1556.  
  1557.   "Sorry .... out of memory"
  1558.   The browser has run out of far memory in which to store the pixels
  1559.   covered by the sub image boxes.  Try again with the main image at lower
  1560.   resolution, and/or reduce the number of TSRs resident in memory when you
  1561.   start Fractint.
  1562.  
  1563.   "Sorry.... read only file, can't delete"/ "can't rename"
  1564.   The file which you were trying to delete or rename has the read only
  1565.   attribute set, you'll need to reset this with your operating system
  1566.   before you can get rid of it.
  1567.  
  1568.  
  1569.  
  1570.  1.15 RDS Commands
  1571.  
  1572.   The following keystrokes function while viewing an RDS image:
  1573.  
  1574.   <Enter> or <Space>   -- Toggle calibration bars on and off.
  1575.   <Ctrl-s> or <k>      -- Return to RDS Parameters Screen.
  1576.   <s>                  -- Save RDS image, then restore original.
  1577.   <c>, <+>, <->        -- Color cycle RDS image.
  1578.   Other keys           -- Exit RDS mode, restore original image, and pass
  1579.                           keystroke on to main menu.
  1580.  
  1581.   For more about RDS, see Random Dot Stereograms (RDS) (p. 82)
  1582.  
  1583.  
  1584.  
  1585.  1.16 Hints
  1586.  
  1587.   Remember, you do NOT have to wait for the program to finish a full
  1588.   screen display before entering a command. If you see an interesting spot
  1589.   you want to zoom in on while the screen is half-done, don't wait -- do
  1590.   it! If you think after seeing the first few lines that another video
  1591.   mode would look better, go ahead -- Fractint will shift modes and start
  1592.   the redraw at once. When it finishes a display, it beeps and waits for
  1593.   your next command.
  1594.  
  1595.   In general, the most interesting areas are the "border" areas where the
  1596.   colors are changing rapidly. Zoom in on them for the best results. The
  1597.   first Mandelbrot-set (default) fractal image has a large, solid-colored
  1598.   interior that is the slowest to display; there's nothing to be seen by
  1599.   zooming there.
  1600.  
  1601.   Plotting time is directly proportional to the number of pixels in a
  1602.   screen, and hence increases with the resolution of the video mode.  You
  1603.   may want to start in a low-resolution mode for quick progress while
  1604.   zooming in, and switch to a higher-resolution mode when things get
  1605.   interesting. Or use the solid guessing mode and pre-empt with a zoom
  1606.   before it finishes. Plotting time also varies with the maximum iteration
  1607.   setting, the fractal type, and your choice of drawing mode.  Solid-
  1608.   guessing (the default) is fastest, but it can be wrong: perfectionists
  1609.   will want to use dual-pass mode (its first-pass preview is handy if you
  1610.   might zoom pre-emptively) or single-pass mode.
  1611.  
  1612.                       Fractint Version 19.2                        Page 31
  1613.  
  1614.   When you start systematically exploring, you can save time (and hey,
  1615.   every little bit helps -- these "objects" are INFINITE, remember!) by
  1616.   <S>aving your last screen in a session to a file, and then going
  1617.   straight to it the next time by using the command FRACTINT FRACTxxx (the
  1618.   .GIF extension is assumed), or by starting Fractint normally and then
  1619.   using the <R> command to reload the saved file. Or you could hit <B> to
  1620.   create a parameter file entry with the "recipe" for a given image, and
  1621.   next time use the <@> command to re-plot it.
  1622.  
  1623.  
  1624.  1.17 Fractint on Unix
  1625.  
  1626.   Fractint has been ported to Unix to run under X Windows.  This version
  1627.   is called "Xfractint".  Xfractint may be obtained by anonymous ftp to
  1628.   sprite.Berkeley.EDU, in the file xfractnnn.shar.Z.
  1629.  
  1630.   Xfractint is still under development and is not as reliable as the IBM
  1631.   PC version.
  1632.  
  1633.   Contact Ken Shirriff (shirriff@cs.Berkeley.EDU) for information on
  1634.   Xfractint.
  1635.  
  1636.   Xfractint is a straight port of the IBM PC version.  Thus, it uses the
  1637.   IBM user interface.  If you do not have function keys, or Xfractint does
  1638.   not accept them from your keyboard, use the following key mappings:
  1639.  
  1640.        IBM             Unix
  1641.        F1 to F10       Shift-1 to Shift-0
  1642.        INSERT          I
  1643.        DELETE          D
  1644.        PAGE_UP         U
  1645.        PAGE_DOWN       N
  1646.        LEFT_ARROW      H
  1647.        RIGHT_ARROW     L
  1648.        UP_ARROW        K
  1649.        DOWN_ARROW      J
  1650.        HOME            O
  1651.        END             E
  1652.        CTL_PLUS        }
  1653.        CTL_MINUS       {
  1654.  
  1655.   Xfractint takes the following options:
  1656.  
  1657.   -onroot
  1658.   Puts the image on the root window.
  1659.  
  1660.   -fast
  1661.   Uses a faster drawing technique.
  1662.  
  1663.   -disk
  1664.   Uses disk video.
  1665.  
  1666.   -geometry WxH[{+-X}{+-Y}]
  1667.   Changes the geometry of the image window.
  1668.  
  1669.                       Fractint Version 19.2                        Page 32
  1670.  
  1671.   -display displayname
  1672.   Specifies the X11 display to use.
  1673.  
  1674.   -private
  1675.   Allocates the entire colormap (i.e. more colors).
  1676.  
  1677.   -share
  1678.   Shares the current colormap.
  1679.  
  1680.   -fixcolors n
  1681.   Uses only n colors.
  1682.  
  1683.   -slowdisplay
  1684.   Prevents xfractint from hanging on the title page with slow displays.
  1685.  
  1686.   -simple
  1687.   Uses simpler keyboard handling, which makes debugging easier.
  1688.  
  1689.   Common problems:
  1690.  
  1691.   If you get the message "Couldn't find fractint.hlp", you can
  1692.   a) Do "setenv FRACTDIR /foo", replacing /foo with the directory
  1693.   containing fractint.hlp.
  1694.   b) Run xfractint from the directory containing fractint.hlp, or
  1695.   c) Copy fractint.hlp to /usr/local/bin/X11/fractint
  1696.  
  1697.   If you get the message "Invalid help signature", the problem is due to
  1698.   byteorder.  You are probably using a Sun help file on a Dec machine or
  1699.   vice versa.
  1700.  
  1701.   If xfractint doesn't accept input, try typing into both the graphics
  1702.   window and the text window.  On some systems, only one of these works.
  1703.  
  1704.   If you are using Openwindows and can't get xfractint to accept input,
  1705.   add to your .Xdefaults file:
  1706.   OpenWindows.FocusLenience:      True
  1707.  
  1708.   If you cannot view the GIFs that xfractint creates, the problem is that
  1709.   xfractint creates GIF89a format and your viewer probably only handles
  1710.   GIF87a format.  Run "xfractint gif87a=y" to produce GIF87a format.
  1711.  
  1712.   Because many shifted characters are used to simulate IBM keys, you can't
  1713.   enter capitalized filenames.
  1714.  
  1715.                       Fractint Version 19.2                        Page 33
  1716.  
  1717.  2. Fractal Types
  1718.  
  1719.   A list of the fractal types and their mathematics can be found in the
  1720.   Summary of Fractal Types (p. 139).  Some notes about how Fractint
  1721.   calculates them are in "A Little Code" in "Fractals and the PC" (p. 132)
  1722.   .
  1723.  
  1724.   Fractint starts by default with the Mandelbrot set. You can change that
  1725.   by using the command-line argument "TYPE=" followed by one of the
  1726.   fractal type names, or by using the <T> command and selecting the type -
  1727.   if parameters are needed, you will be prompted for them.
  1728.  
  1729.   In the text that follows, due to the limitations of the ASCII character
  1730.   set, "a*b" means "a times b", and "a^b" means "a to the power b".
  1731.  
  1732.  
  1733.  
  1734.  2.1 The Mandelbrot Set
  1735.  
  1736.   (type=mandel)
  1737.  
  1738.   This set is the classic: the only one implemented in many plotting
  1739.   programs, and the source of most of the printed fractal images published
  1740.   in recent years. Like most of the other types in Fractint, it is simply
  1741.   a graph: the x (horizontal) and y (vertical) coordinate axes represent
  1742.   ranges of two independent quantities, with various colors used to
  1743.   symbolize levels of a third quantity which depends on the first two. So
  1744.   far, so good: basic analytic geometry.
  1745.  
  1746.   Now things get a bit hairier. The x axis is ordinary, vanilla real
  1747.   numbers. The y axis is an imaginary number, i.e. a real number times i,
  1748.   where i is the square root of -1. Every point on the plane -- in this
  1749.   case, your PC's display screen -- represents a complex number of the
  1750.   form:
  1751.  
  1752.       x-coordinate + i * y-coordinate
  1753.  
  1754.   If your math training stopped before you got to imaginary and complex
  1755.   numbers, this is not the place to catch up. Suffice it to say that they
  1756.   are just as "real" as the numbers you count fingers with (they're used
  1757.   every day by electrical engineers) and they can undergo the same kinds
  1758.   of algebraic operations.
  1759.  
  1760.   OK, now pick any complex number -- any point on the complex plane -- and
  1761.   call it C, a constant. Pick another, this time one which can vary, and
  1762.   call it Z. Starting with Z=0 (i.e., at the origin, where the real and
  1763.   imaginary axes cross), calculate the value of the expression
  1764.  
  1765.       Z^2 + C
  1766.  
  1767.   Take the result, make it the new value of the variable Z, and calculate
  1768.   again. Take that result, make it Z, and do it again, and so on: in
  1769.   mathematical terms, iterate the function Z(n+1) = Z(n)^2 + C. For
  1770.   certain values of C, the result "levels off" after a while. For all
  1771.   others, it grows without limit. The Mandelbrot set you see at the start
  1772.   -- the solid-colored lake (blue by default), the blue circles sprouting
  1773.  
  1774.                       Fractint Version 19.2                        Page 34
  1775.  
  1776.   from it, and indeed every point of that color -- is the set of all
  1777.   points C for which the magnitude of Z is less than 2 after 150
  1778.   iterations (150 is the default setting, changeable via the <X> options
  1779.   screen or "maxiter=" parameter).  All the surrounding "contours" of
  1780.   other colors represent points for which the magnitude of Z exceeds 2
  1781.   after 149 iterations (the contour closest to the M-set itself), 148
  1782.   iterations, (the next one out), and so on.
  1783.  
  1784.   We actually don't test for the magnitude of Z exceeding 2 - we test the
  1785.   magnitude of Z squared against 4 instead because it is easier.  This
  1786.   value (FOUR usually) is known as the "bailout" value for the
  1787.   calculation, because we stop iterating for the point when it is reached.
  1788.   The bailout value can be changed on the <Z> options screen but the
  1789.   default is usually best.  See also Bailout Test (p. 81).
  1790.  
  1791.   Some features of interest:
  1792.  
  1793.   1. Use the <X> options screen to increase the maximum number of
  1794.   iterations.  Notice that the boundary of the M-set becomes more and more
  1795.   convoluted (the technical terms are "wiggly," "squiggly," and "utterly
  1796.   bizarre") as the Z-magnitudes for points that were still within the set
  1797.   after 150 iterations turn out to exceed 2 after 200, 500, or 1200. In
  1798.   fact, it can be proven that the true boundary is infinitely long: detail
  1799.   without limit.
  1800.  
  1801.   2. Although there appear to be isolated "islands" of blue, zoom in --
  1802.   that is, plot for a smaller range of coordinates to show more detail --
  1803.   and you'll see that there are fine "causeways" of blue connecting them
  1804.   to the main set. As you zoomed, smaller islands became visible; the same
  1805.   is true for them. In fact, there are no isolated points in the M-set: it
  1806.   is "connected" in a strict mathematical sense.
  1807.  
  1808.   3. The upper and lower halves of the first image are symmetric (a fact
  1809.   that Fractint makes use of here and in some other fractal types to speed
  1810.   plotting). But notice that the same general features -- lobed discs,
  1811.   spirals, starbursts -- tend to repeat themselves (although never
  1812.   exactly) at smaller and smaller scales, so that it can be impossible to
  1813.   judge by eye the scale of a given image.
  1814.  
  1815.   4. In a sense, the contour colors are window-dressing: mathematically,
  1816.   it is the properties of the M-set itself that are interesting, and no
  1817.   information about it would be lost if all points outside the set were
  1818.   assigned the same color. If you're a serious, no-nonsense type, you may
  1819.   want to cycle the colors just once to see the kind of silliness that
  1820.   other people enjoy, and then never do it again. Go ahead. Just once,
  1821.   now. We trust you.
  1822.  
  1823.  
  1824.  2.2 Julia Sets
  1825.  
  1826.   (type=julia)
  1827.  
  1828.   These sets were named for mathematician Gaston Julia, and can be
  1829.   generated by a simple change in the iteration process described for the
  1830.   Mandelbrot Set (p. 33).  Start with a specified value of C, "C-real + i
  1831.   * C-imaginary"; use as the initial value of Z "x-coordinate + i * y-
  1832.  
  1833.                       Fractint Version 19.2                        Page 35
  1834.  
  1835.   coordinate"; and repeat the same iteration, Z(n+1) = Z(n)^2 + C.
  1836.  
  1837.   There is a Julia set corresponding to every point on the complex plane
  1838.   -- an infinite number of Julia sets. But the most visually interesting
  1839.   tend to be found for the same C values where the M-set image is busiest,
  1840.   i.e.  points just outside the boundary. Go too far inside, and the
  1841.   corresponding Julia set is a circle; go too far outside, and it breaks
  1842.   up into scattered points. In fact, all Julia sets for C within the M-set
  1843.   share the "connected" property of the M-set, and all those for C outside
  1844.   lack it.
  1845.  
  1846.   Fractint's spacebar toggle lets you "flip" between any view of the M-set
  1847.   and the Julia set for the point C at the center of that screen. You can
  1848.   then toggle back, or zoom your way into the Julia set for a while and
  1849.   then return to the M-set. So if the infinite complexity of the M-set
  1850.   palls, remember: each of its infinite points opens up a whole new Julia
  1851.   set.
  1852.  
  1853.   Historically, the Julia sets came first: it was while looking at the M-
  1854.   set as an "index" of all the Julia sets' origins that Mandelbrot noticed
  1855.   its properties.
  1856.  
  1857.   The relationship between the Mandelbrot (p. 33) set and Julia set can
  1858.   hold between other sets as well.  Many of Fractint's types are
  1859.   "Mandelbrot/Julia" pairs (sometimes called "M-sets" or "J-sets". All
  1860.   these are generated by equations that are of the form z(k+1) =
  1861.   f(z(k),c), where the function orbit is the sequence z(0), z(1), ..., and
  1862.   the variable c is a complex parameter of the equation. The value c is
  1863.   fixed for "Julia" sets and is equal to the first two parameters entered
  1864.   with the "params=Creal/Cimag" command. The initial orbit value z(0) is
  1865.   the complex number corresponding to the screen pixel. For Mandelbrot
  1866.   sets, the parameter c is the complex number corresponding to the screen
  1867.   pixel. The value z(0) is c plus a perturbation equal to the values of
  1868.   the first two parameters.  See the discussion of Mandellambda Sets
  1869.   (p. 39).  This approach may or may not be the "standard" way to create
  1870.   "Mandelbrot" sets out of "Julia" sets.
  1871.  
  1872.   Some equations have additional parameters.  These values are entered as
  1873.   the third or fourth params= value for both Julia and Mandelbrot sets.
  1874.   The variables x and y refer to the real and imaginary parts of z;
  1875.   similarly, cx and cy are the real and imaginary parts of the parameter c
  1876.   and fx(z) and fy(z) are the real and imaginary parts of f(z). The
  1877.   variable c is sometimes called lambda for historical reasons.
  1878.  
  1879.   NOTE: if you use the "PARAMS=" argument to warp the M-set by starting
  1880.   with an initial value of Z other than 0, the M-set/J-sets correspondence
  1881.   breaks down and the spacebar toggle no longer works.
  1882.  
  1883.  
  1884.  2.3 Julia Toggle Spacebar Commands
  1885.  
  1886.   The spacebar toggle has been enhanced for the classic Mandelbrot and
  1887.   Julia types. When viewing the Mandelbrot, the spacebar turns on a window
  1888.   mode that displays the Inverse Julia corresponding to the cursor
  1889.   position in a window.  Pressing the spacebar then causes the regular
  1890.   Julia escape time fractal corresponding to the cursor position to be
  1891.  
  1892.                       Fractint Version 19.2                        Page 36
  1893.  
  1894.   generated. The following keys take effect in Inverse Julia mode.
  1895.  
  1896.   <Space>     Generate the escape-time Julia Set corresponding to the
  1897.   cursor
  1898.               position. Only works if fractal is a "Mandelbrot" type.
  1899.   <n>         Numbers toggle - shows coordinates of the cursor on the
  1900.               screen. Press <n> again to turn off numbers.
  1901.   <p>         Enter new pixel coordinates directly
  1902.   <h>         Hide fractal toggle. Works only if View Windows is turned on
  1903.               and set for a small window (such as the default size.) Hides
  1904.               the fractal, allowing the orbit to take up the whole screen.
  1905.               Press <h> again to uncover the fractal.
  1906.   <s>         Saves the fractal, cursor, orbits, and numbers.
  1907.   <<> or <,>  Zoom inverse julia image smaller.
  1908.   <>> or <.>  Zoom inverse julia image larger.
  1909.   <z>         Restore default zoom.
  1910.  
  1911.   The Julia Inverse window is only implemented for the classic Mandelbrot
  1912.   (type=mandel). For other "Mandelbrot" types <space> turns on the cursor
  1913.   without the Julia window, and allows you to select coordinates of the
  1914.   matching Julia set in a way similar to the use of the zoom box with the
  1915.   Mandelbrot/Julia toggle in previous Fractint versions.
  1916.  
  1917.  
  1918.  2.4 Inverse Julias
  1919.  
  1920.   (type=julia_inverse)
  1921.  
  1922.   Pick a function, such as the familiar Z(n) = Z(n-1) squared plus C (the
  1923.   defining function of the Mandelbrot Set).  If you pick a point Z(0) at
  1924.   random from the complex plane, and repeatedly apply the function to it,
  1925.   you get a sequence of new points called an orbit, which usually either
  1926.   zips out toward infinity or zooms in toward one or more "attractor"
  1927.   points near the middle of the plane.  The set of all points that are
  1928.   "attracted" to infinity is called the "Basin of Attraction" of infinity.
  1929.   Each of the other attractors also has its own Basin of Attraction.  Why
  1930.   is it called a Basin?  Imagine a lake, and all the water in it
  1931.   "draining" into the attractor.  The boundary between these basins is
  1932.   called the Julia Set of the function.
  1933.  
  1934.   The boundary between the basins of attraction is sort of like a
  1935.   repeller; all orbits move away from it, toward one of the attractors.
  1936.   But if we define a new function as the inverse of the old one, as for
  1937.   instance Z(n) = sqrt(Z(n-1) minus C), then the old attractors become
  1938.   repellers, and the former boundary itself becomes the attractor!  Now,
  1939.   starting from any point, all orbits are drawn irresistibly to the Julia
  1940.   Set!  In fact, once an orbit reaches the boundary, it will continue to
  1941.   hop about until it traces the entire Julia Set!  This method for drawing
  1942.   Julia Sets is called the Inverse Iteration Method, or IIM for short.
  1943.  
  1944.   Unfortunately, some parts of each Julia Set boundary are far more
  1945.   attractive to inverse orbits than others are, so that as an orbit traces
  1946.   out the set, it keeps coming back to these attractive parts again and
  1947.   again, only occasionally visiting the less attractive parts.  Thus it
  1948.   may take an infinite length of time to draw the entire set.  To hasten
  1949.   the process, we can keep track of how many times each pixel on our
  1950.  
  1951.                       Fractint Version 19.2                        Page 37
  1952.  
  1953.   computer screen is visited by an orbit, and whenever an orbit reaches a
  1954.   pixel that has already been visited more than a certain number of times,
  1955.   we can consider that orbit finished and move on to another one.  This
  1956.   "hit limit" thus becomes similar to the iteration limit used in the
  1957.   traditional escape-time fractal algorithm.  This is called the Modified
  1958.   Inverse Iteration Method, or MIIM, and is much faster than the IIM.
  1959.  
  1960.   Now, the inverse of Mandelbrot's classic function is a square root, and
  1961.   the square root actually has two solutions; one positive, one negative.
  1962.   Therefore at each step of each orbit of the inverse function there is a
  1963.   decision; whether to use the positive or the negative square root.  Each
  1964.   one gives rise to a new point on the Julia Set, so each is a good
  1965.   choice.  This series of choices defines a binary decision tree, each
  1966.   point on the Julia Set giving rise to two potential child points.  There
  1967.   are many interesting ways to traverse a binary tree, among them Breadth
  1968.   first, Depth first (left or negative first), Depth first (right or
  1969.   positive first), and completely at random.  It turns out that most
  1970.   traversal methods lead to the same or similar pictures, but that how the
  1971.   image evolves as the orbits trace it out differs wildly depending on the
  1972.   traversal method chosen.  As far as we know, this fact is an original
  1973.   discovery by Michael Snyder, and version 18.2 of FRACTINT was its first
  1974.   publication.
  1975.  
  1976.   Pick a Julia constant such as Z(0) = (-.74543, .11301), the popular
  1977.   Seahorse Julia, and try drawing it first Breadth first, then Depth first
  1978.   (right first), Depth first (left first), and finally with Random Walk.
  1979.  
  1980.   Caveats: the video memory is used in the algorithm, to keep track of how
  1981.   many times each pixel has been visited (by changing it's color).
  1982.   Therefore the algorithm will not work well if you zoom in far enough
  1983.   that part of the Julia Set is off the screen.
  1984.  
  1985.   Bugs:   Not working with Disk Video.
  1986.           Not resumeable.
  1987.  
  1988.   The <J> key toggles between the Inverse Julia orbit and the
  1989.   corresponding Julia escape time fractal.
  1990.  
  1991.  
  1992.  2.5 Newton domains of attraction
  1993.  
  1994.   (type=newtbasin)
  1995.  
  1996.   The Newton formula is an algorithm used to find the roots of polynomial
  1997.   equations by successive "guesses" that converge on the correct value as
  1998.   you feed the results of each approximation back into the formula. It
  1999.   works very well -- unless you are unlucky enough to pick a value that is
  2000.   on a line BETWEEN two actual roots. In that case, the sequence explodes
  2001.   into chaos, with results that diverge more and more wildly as you
  2002.   continue the iteration.
  2003.  
  2004.   This fractal type shows the results for the polynomial Z^n - 1, which
  2005.   has n roots in the complex plane. Use the <T>ype command and enter
  2006.   "newtbasin" in response to the prompt. You will be asked for a
  2007.   parameter, the "order" of the equation (an integer from 3 through 10 --
  2008.   3 for x^3-1, 7 for x^7-1, etc.). A second parameter is a flag to turn on
  2009.  
  2010.                       Fractint Version 19.2                        Page 38
  2011.  
  2012.   alternating shades showing changes in the number of iterations needed to
  2013.   attract an orbit. Some people like stripes and some don't, as always,
  2014.   Fractint gives you a choice!
  2015.  
  2016.   The coloring of the plot shows the "basins of attraction" for each root
  2017.   of the polynomial -- i.e., an initial guess within any area of a given
  2018.   color would lead you to one of the roots. As you can see, things get a
  2019.   bit weird along certain radial lines or "spokes," those being the lines
  2020.   between actual roots. By "weird," we mean infinitely complex in the good
  2021.   old fractal sense. Zoom in and see for yourself.
  2022.  
  2023.   This fractal type is symmetric about the origin, with the number of
  2024.   "spokes" depending on the order you select. It uses floating-point math
  2025.   if you have an FPU, or a somewhat slower integer algorithm if you don't
  2026.   have one.
  2027.  
  2028.  
  2029.  2.6 Newton
  2030.  
  2031.   (type=newton)
  2032.  
  2033.   The generating formula here is identical to that for newtbasin (p. 37),
  2034.   but the coloring scheme is different. Pixels are colored not according
  2035.   to the root that would be "converged on" if you started using Newton's
  2036.   formula from that point, but according to the iteration when the value
  2037.   is close to a root.  For example, if the calculations for a particular
  2038.   pixel converge to the 7th root on the 23rd iteration, NEWTBASIN will
  2039.   color that pixel using color #7, but NEWTON will color it using color
  2040.   #23.
  2041.  
  2042.   If you have a 256-color mode, use it: the effects can be much livelier
  2043.   than those you get with type=newtbasin, and color cycling becomes, like,
  2044.   downright cosmic. If your "corners" choice is symmetrical, Fractint
  2045.   exploits the symmetry for faster display.
  2046.  
  2047.   The applicable "params=" values are the same as newtbasin. Try
  2048.   "params=4."  Other values are 3 through 10. 8 has twice the symmetry and
  2049.   is faster. As with newtbasin, an FPU helps.
  2050.  
  2051.  
  2052.  2.7 Complex Newton
  2053.  
  2054.   (type=complexnewton/complexbasin)
  2055.  
  2056.   Well, hey, "Z^n - 1" is so boring when you can use "Z^a - b" where "a"
  2057.   and "b" are complex numbers!  The new "complexnewton" and "complexbasin"
  2058.   fractal types are just the old "newton" (p. 38) and "newtbasin"
  2059.   (p. 37) fractal types with this little added twist.  When you select
  2060.   these fractal types, you are prompted for four values (the real and
  2061.   imaginary portions of "a" and "b").  If "a" has a complex portion, the
  2062.   fractal has a discontinuity along the negative axis - relax, we finally
  2063.   figured out that it's *supposed* to be there!
  2064.  
  2065.                       Fractint Version 19.2                        Page 39
  2066.  
  2067.  2.8 Lambda Sets
  2068.  
  2069.   (type=lambda)
  2070.  
  2071.   This type calculates the Julia set of the formula lambda*Z*(1-Z). That
  2072.   is, the value Z[0] is initialized with the value corresponding to each
  2073.   pixel position, and the formula iterated. The pixel is colored according
  2074.   to the iteration when the sum of the squares of the real and imaginary
  2075.   parts exceeds 4.
  2076.  
  2077.   Two parameters, the real and imaginary parts of lambda, are required.
  2078.   Try 0 and 1 to see the classical fractal "dragon". Then try 0.2 and 1
  2079.   for a lot more detail to zoom in on.
  2080.  
  2081.   It turns out that all quadratic Julia-type sets can be calculated using
  2082.   just the formula z^2+c (the "classic" Julia"), so that this type is
  2083.   redundant, but we include it for reason of it's prominence in the
  2084.   history of fractals.
  2085.  
  2086.  
  2087.  2.9 Mandellambda Sets
  2088.  
  2089.   (type=mandellambda)
  2090.  
  2091.   This type is the "Mandelbrot equivalent" of the lambda (p. 39) set.  A
  2092.   comment is in order here. Almost all the Fractint "Mandelbrot" sets are
  2093.   created from orbits generated using formulas like z(n+1) = f(z(n),C),
  2094.   with z(0) and C initialized to the complex value corresponding to the
  2095.   current pixel. Our reasoning was that "Mandelbrots" are maps of the
  2096.   corresponding "Julias".  Using this scheme each pixel of a "Mandelbrot"
  2097.   is colored the same as the Julia set corresponding to that pixel.
  2098.   However, Kevin Allen informs us that the MANDELLAMBDA set appears in the
  2099.   literature with z(0) initialized to a critical point (a point where the
  2100.   derivative of the formula is zero), which in this case happens to be the
  2101.   point (.5,0). Since Kevin knows more about Dr. Mandelbrot than we do,
  2102.   and Dr. Mandelbrot knows more about fractals than we do, we defer!
  2103.   Starting with version 14 Fractint calculates MANDELAMBDA Dr.
  2104.   Mandelbrot's way instead of our way. But ALL THE OTHER "Mandelbrot" sets
  2105.   in Fractint are still calculated OUR way!  (Fortunately for us, for the
  2106.   classic Mandelbrot Set these two methods are the same!)
  2107.  
  2108.   Well now, folks, apart from questions of faithfulness to fractals named
  2109.   in the literature (which we DO take seriously!), if a formula makes a
  2110.   beautiful fractal, it is not wrong. In fact some of the best fractals in
  2111.   Fractint are the results of mistakes! Nevertheless, thanks to Kevin for
  2112.   keeping us accurate!
  2113.  
  2114.   (See description of "initorbit=" command in Image Calculation Parameters
  2115.   (p. 104) for a way to experiment with different orbit intializations).
  2116.  
  2117.                       Fractint Version 19.2                        Page 40
  2118.  
  2119.  2.10 Circle
  2120.  
  2121.   (type=circle)
  2122.  
  2123.   This fractal types is from A. K. Dewdney's "Computer Recreations" column
  2124.   in "Scientific American". It is attributed to John Connett of the
  2125.   University of Minnesota.
  2126.  
  2127.   (Don't tell anyone, but this fractal type is not really a fractal!)
  2128.  
  2129.   Fascinating Moire patterns can be formed by calculating x^2 + y^2 for
  2130.   each pixel in a piece of the complex plane. After multiplication by a
  2131.   magnification factor (the parameter), the number is truncated to an
  2132.   integer and mapped to a color via color = value modulo (number of
  2133.   colors). That is, the integer is divided by the number of colors, and
  2134.   the remainder is the color index value used.  The resulting image is not
  2135.   a fractal because all detail is lost after zooming in too far. Try it
  2136.   with different resolution video modes - the results may surprise you!
  2137.  
  2138.  
  2139.  2.11 Plasma Clouds
  2140.  
  2141.   (type=plasma)
  2142.  
  2143.   Plasma clouds ARE real live fractals, even though we didn't know it at
  2144.   first. They are generated by a recursive algorithm that randomly picks
  2145.   colors of the corner of a rectangle, and then continues recursively
  2146.   quartering previous rectangles. Random colors are averaged with those of
  2147.   the outer rectangles so that small neighborhoods do not show much
  2148.   change, for a smoothed-out, cloud-like effect. The more colors your
  2149.   video mode supports, the better.  The result, believe it or not, is a
  2150.   fractal landscape viewed as a contour map, with colors indicating
  2151.   constant elevation.  To see this, save and view with the <3> command
  2152.   (see "3D" Images (p. 85)) and your "cloud" will be converted to a
  2153.   mountain!
  2154.  
  2155.   You've GOT to try color cycling (p. 16) on these (hit "+" or "-").  If
  2156.   you haven't been hypnotized by the drawing process, the writhing colors
  2157.   will do it for sure. We have now implemented subliminal messages to
  2158.   exploit the user's vulnerable state; their content varies with your bank
  2159.   balance, politics, gender, accessibility to a Fractint programmer, and
  2160.   so on. A free copy of Microsoft C to the first person who spots them.
  2161.  
  2162.   This type accepts four parameters.
  2163.  
  2164.   The first determines how abruptly the colors change. A value of .5
  2165.   yields bland clouds, while 50 yields very grainy ones. The default value
  2166.   is 2.
  2167.  
  2168.   The second determines whether to use the original algorithm (0) or a
  2169.   modified one (1). The new one gives the same type of images but draws
  2170.   the dots in a different order. It will let you see what the final image
  2171.   will look like much sooner than the old one.
  2172.  
  2173.                       Fractint Version 19.2                        Page 41
  2174.  
  2175.   The third determines whether to use a new seed for generating the next
  2176.   plasma cloud (0) or to use the previous seed (1).
  2177.  
  2178.   The fourth parameter turns on 16-bit .POT output which provides much
  2179.   smoother height gradations. This is especially useful for creating
  2180.   mountain landscapes when using the plasma output with a ray tracer such
  2181.   as POV-Ray.
  2182.  
  2183.   With parameter three set to 1, the next plasma cloud generated will be
  2184.   identical to the previous but at whatever new resolution is desired.
  2185.  
  2186.   Zooming is ignored, as each plasma-cloud screen is generated randomly.
  2187.  
  2188.   The random number seed used for each plasma image is displayed on the
  2189.   <tab> information screen, and can be entered with the command line
  2190.   parameter "rseed=" to recreate a particular image.
  2191.  
  2192.   The algorithm is based on the Pascal program distributed by Bret Mulvey
  2193.   as PLASMA.ARC. We have ported it to C and integrated it with Fractint's
  2194.   graphics and animation facilities. This implementation does not use
  2195.   floating-point math. The algorithm was modified starting with version 18
  2196.   so that the plasma effect is independent of screen resolution.
  2197.  
  2198.   Saved plasma-cloud screens are EXCELLENT starting images for fractal
  2199.   "landscapes" created with the "3D" commands (p. 25).
  2200.  
  2201.  
  2202.  2.12 Lambdafn
  2203.  
  2204.   (type=lambdafn)
  2205.  
  2206.   Function=[sin|cos|sinh|cosh|exp|log|sqr|...]) is specified with this
  2207.   type.  Prior to version 14, these types were lambdasine, lambdacos,
  2208.   lambdasinh, lambdacos, and lambdaexp.  Where we say "lambdasine" or some
  2209.   such below, the good reader knows we mean "lambdafn with function=sin".)
  2210.  
  2211.   These types calculate the Julia set of the formula lambda*fn(Z), for
  2212.   various values of the function "fn", where lambda and Z are both
  2213.   complex.  Two values, the real and imaginary parts of lambda, should be
  2214.   given in the "params=" option.  For the feathery, nested spirals of
  2215.   LambdaSines and the frost-on-glass patterns of LambdaCosines, make the
  2216.   real part = 1, and try values for the imaginary part ranging from 0.1 to
  2217.   0.4 (hint: values near 0.4 have the best patterns). In these ranges the
  2218.   Julia set "explodes". For the tongues and blobs of LambdaExponents, try
  2219.   a real part of 0.379 and an imaginary part of 0.479.
  2220.  
  2221.   A coprocessor used to be almost mandatory: each LambdaSine/Cosine
  2222.   iteration calculates a hyperbolic sine, hyperbolic cosine, a sine, and a
  2223.   cosine (the LambdaExponent iteration "only" requires an exponent, sine,
  2224.   and cosine operation)!  However, Fractint now computes these
  2225.   transcendental functions with fast integer math. In a few cases the fast
  2226.   math is less accurate, so we have kept the old slow floating point code.
  2227.   To use the old code, invoke with the float=yes option, and, if you DON'T
  2228.   have a coprocessor, go on a LONG vacation!
  2229.  
  2230.                       Fractint Version 19.2                        Page 42
  2231.  
  2232.  2.13 Mandelfn
  2233.  
  2234.   (type=mandelfn)
  2235.  
  2236.   Function=[sin|cos|sinh|cosh|exp|log|sqr|...]) is specified with this
  2237.   type.  Prior to version 14, these types were mandelsine, mandelcos,
  2238.   mandelsinh, mandelcos, and mandelexp. Same comment about our lapses into
  2239.   the old terminology as above!
  2240.  
  2241.   These are "pseudo-Mandelbrot" mappings for the LambdaFn (p. 41) Julia
  2242.   functions.  They map to their corresponding Julia sets via the spacebar
  2243.   command in exactly the same fashion as the original M/J sets.  In
  2244.   general, they are interesting mainly because of that property (the
  2245.   function=exp set in particular is rather boring). Generate the
  2246.   appropriate "Mandelfn" set, zoom on a likely spot where the colors are
  2247.   changing rapidly, and hit the spacebar key to plot the Julia set for
  2248.   that particular point.
  2249.  
  2250.   Try "FRACTINT TYPE=MANDELFN CORNERS=4.68/4.76/-.03/.03 FUNCTION=COS" for
  2251.   a graphic demonstration that we're not taking Mandelbrot's name in vain
  2252.   here. We didn't even know these little buggers were here until Mark
  2253.   Peterson found this a few hours before the version incorporating
  2254.   Mandelfns was released.
  2255.  
  2256.   Note: If you created images using the lambda or mandel "fn" types prior
  2257.   to version 14, and you wish to update the fractal information in the
  2258.   "*.fra" file, simply read the files and save again. You can do this in
  2259.   batch mode via a command line such as:
  2260.  
  2261.        "fractint oldfile.fra savename=newfile.gif batch=yes"
  2262.  
  2263.   For example, this procedure can convert a version 13 "type=lambdasine"
  2264.   image to a version 14 "type=lambdafn function=sin" GIF89a image.  We do
  2265.   not promise to keep this "backward compatibility" past version 14 - if
  2266.   you want to keep the fractal information in your *.fra files accurate,
  2267.   we recommend conversion.  See GIF Save File Format (p. 166).
  2268.  
  2269.  
  2270.  2.14 Barnsley Mandelbrot/Julia Sets
  2271.  
  2272.   (type=barnsleym1/.../j3)
  2273.  
  2274.   Michael Barnsley has written a fascinating college-level text, "Fractals
  2275.   Everywhere," on fractal geometry and its graphic applications. (See
  2276.   Bibliography (p. 169).) In it, he applies the principle of the M and J
  2277.   sets to more general functions of two complex variables.
  2278.  
  2279.   We have incorporated three of Barnsley's examples in Fractint. Their
  2280.   appearance suggests polarized-light microphotographs of minerals, with
  2281.   patterns that are less organic and more crystalline than those of the
  2282.   M/J sets. Each example has both a "Mandelbrot" and a "Julia" type.
  2283.   Toggle between them using the spacebar.
  2284.  
  2285.   The parameters have the same meaning as they do for the "regular"
  2286.   Mandelbrot and Julia. For types M1, M2, and M3, they are used to "warp"
  2287.   the image by setting the initial value of Z. For the types J1 through
  2288.  
  2289.                       Fractint Version 19.2                        Page 43
  2290.  
  2291.   J3, they are the values of C in the generating formulas.
  2292.  
  2293.   Be sure to try the <O>rbit function while plotting these types.
  2294.  
  2295.  
  2296.  2.15 Barnsley IFS Fractals
  2297.  
  2298.   (type=ifs)
  2299.  
  2300.   One of the most remarkable spin-offs of fractal geometry is the ability
  2301.   to "encode" realistic images in very small sets of numbers -- parameters
  2302.   for a set of functions that map a region of two-dimensional space onto
  2303.   itself.  In principle (and increasingly in practice), a scene of any
  2304.   level of complexity and detail can be stored as a handful of numbers,
  2305.   achieving amazing "compression" ratios... how about a super-VGA image of
  2306.   a forest, more than 300,000 pixels at eight bits apiece, from a 1-KB
  2307.   "seed" file?
  2308.  
  2309.   Again, Michael Barnsley and his co-workers at the Georgia Institute of
  2310.   Technology are to be thanked for pushing the development of these
  2311.   iterated function systems (IFS).
  2312.  
  2313.   When you select this fractal type, Fractint scans the current IFS file
  2314.   (default is FRACTINT.IFS, a set of definitions supplied with Fractint)
  2315.   for IFS definitions, then prompts you for the IFS name you wish to run.
  2316.   Fern and 3dfern are good ones to start with. You can press <F6> at the
  2317.   selection screen if you want to select a different .IFS file you've
  2318.   written.
  2319.  
  2320.   Note that some Barnsley IFS values generate images quite a bit smaller
  2321.   than the initial (default) screen. Just bring up the zoom box, center it
  2322.   on the small image, and hit <Enter> to get a full-screen image.
  2323.  
  2324.   To change the number of dots Fractint generates for an IFS image before
  2325.   stopping, you can change the "maximum iterations" parameter on the <X>
  2326.   options screen.
  2327.  
  2328.   Fractint supports two types of IFS images: 2D and 3D. In order to fully
  2329.   appreciate 3D IFS images, since your monitor is presumably 2D, we have
  2330.   added rotation, translation, and perspective capabilities. These share
  2331.   values with the same variables used in Fractint's other 3D facilities;
  2332.   for their meaning see "Rectangular Coordinate Transformation" (p. 90).
  2333.   You can enter these values from the command line using:
  2334.  
  2335.   rotation=xrot/yrot/zrot       (try 30/30/30)
  2336.   shift=xshift/yshift           (shifts BEFORE applying perspective!)
  2337.   perspective=viewerposition    (try 200)
  2338.  
  2339.   Alternatively, entering <I> from main screen will allow you to modify
  2340.   these values. The defaults are the same as for regular 3D, and are not
  2341.   always optimum for 3D IFS. With the 3dfern IFS type, try
  2342.   rotation=30/30/30. Note that applying shift when using perspective
  2343.   changes the picture -- your "point of view" is moved.
  2344.  
  2345.                       Fractint Version 19.2                        Page 44
  2346.  
  2347.   A truly wild variation of 3D may be seen by entering "2" for the stereo
  2348.   mode (see "Stereo 3D Viewing" (p. 89)), putting on red/blue "funny
  2349.   glasses", and watching the fern develop with full depth perception right
  2350.   there before your eyes!
  2351.  
  2352.   This feature USED to be dedicated to Bruce Goren, as a bribe to get him
  2353.   to send us MORE knockout stereo slides of 3D ferns, now that we have
  2354.   made it so easy! Bruce, what have you done for us *LATELY* ?? (Just
  2355.   kidding, really!)
  2356.  
  2357.   Each line in an IFS definition (look at FRACTINT.IFS with your editor
  2358.   for examples) contains the parameters for one of the generating
  2359.   functions, e.g. in FERN:
  2360.      a    b     c    d    e    f    p
  2361.    ___________________________________
  2362.      0     0    0  .16    0    0   .01
  2363.    .85   .04 -.04  .85    0  1.6   .85
  2364.    .2   -.26  .23  .22    0  1.6   .07
  2365.   -.15   .28  .26  .24    0  .44   .07
  2366.  
  2367.   The values on each line define a matrix, vector, and probability:
  2368.       matrix   vector  prob
  2369.       |a b|     |e|     p
  2370.       |c d|     |f|
  2371.  
  2372.   The "p" values are the probabilities assigned to each function (how
  2373.   often it is used), which add up to one. Fractint supports up to 32
  2374.   functions, although usually three or four are enough.
  2375.  
  2376.   3D IFS definitions are a bit different.  The name is followed by (3D) in
  2377.   the definition file, and each line of the definition contains 13
  2378.   numbers: a b c d e f g h i j k l p, defining:
  2379.       matrix   vector  prob
  2380.       |a b c|   |j|     p
  2381.       |d e f|   |k|
  2382.       |g h i|   |l|
  2383.  
  2384.   The program FDESIGN can be used to design IFS fractals - see FDESIGN
  2385.   (p. 171).
  2386.  
  2387.   You can save the points in your IFS fractal in the file ORBITS.RAW which
  2388.   is overwritten each time a fractal is generated. The program Acrospin
  2389.   can read this file and will let you view the fractal from any angle
  2390.   using the cursor keys. See Acrospin (p. 171).
  2391.  
  2392.  
  2393.  2.16 Sierpinski Gasket
  2394.  
  2395.   (type=sierpinski)
  2396.  
  2397.   Another pre-Mandelbrot classic, this one found by W. Sierpinski around
  2398.   World War I. It is generated by dividing a triangle into four congruent
  2399.   smaller triangles, doing the same to each of them, and so on, yea, even
  2400.   unto infinity. (Notice how hard we try to avoid reiterating
  2401.   "iterating"?)
  2402.  
  2403.                       Fractint Version 19.2                        Page 45
  2404.  
  2405.   If you think of the interior triangles as "holes", they occupy more and
  2406.   more of the total area, while the "solid" portion becomes as hopelessly
  2407.   fragile as that gasket you HAD to remove without damaging it -- you
  2408.   remember, that Sunday afternoon when all the parts stores were closed?
  2409.   There's a three-dimensional equivalent using nested tetrahedrons instead
  2410.   of triangles, but it generates too much pyramid power to be safely
  2411.   unleashed yet.
  2412.  
  2413.   There are no parameters for this type. We were able to implement it with
  2414.   integer math routines, so it runs fairly quickly even without an FPU.
  2415.  
  2416.  
  2417.  2.17 Quartic Mandelbrot/Julia
  2418.  
  2419.   (type=mandel4/julia4)
  2420.  
  2421.   These fractal types are the moral equivalent of the original M and J
  2422.   sets, except that they use the formula Z(n+1) = Z(n)^4 + C, which adds
  2423.   additional pseudo-symmetries to the plots. The "Mandel4" set maps to the
  2424.   "Julia4" set via -- surprise! -- the spacebar toggle. The M4 set is kind
  2425.   of boring at first (the area between the "inside" and the "outside" of
  2426.   the set is pretty thin, and it tends to take a few zooms to get to any
  2427.   interesting sections), but it looks nice once you get there. The Julia
  2428.   sets look nice right from the start.
  2429.  
  2430.   Other powers, like Z(n)^3 or Z(n)^7, work in exactly the same fashion.
  2431.   We used this one only because we're lazy, and Z(n)^4 = (Z(n)^2)^2.
  2432.  
  2433.  
  2434.  2.18 Distance Estimator
  2435.  
  2436.   (distest=nnn/nnn)
  2437.  
  2438.   This used to be type=demm and type=demj.  These types have not died, but
  2439.   are only hiding!  They are equivalent to the mandel and julia types with
  2440.   the "distest=" option selected with a predetermined value.
  2441.  
  2442.   The Distance Estimator Method (p. 74) can be used to produce higher
  2443.   quality images of M and J sets, especially suitable for printing in
  2444.   black and white.
  2445.  
  2446.   If you have some *.fra files made with the old types demm/demj, you may
  2447.   want to convert them to the new form.  See the Mandelfn (p. 42) section
  2448.   for directions to carry out the conversion.
  2449.  
  2450.  
  2451.  2.19 Pickover Mandelbrot/Julia Types
  2452.  
  2453.   (type=manfn+zsqrd/julfn+zsqrd, manzpowr/julzpowr, manzzpwr/julzzpwr,
  2454.   manfn+exp/julfn+exp - formerly included man/julsinzsqrd and
  2455.   man/julsinexp which have now been generalized)
  2456.  
  2457.   These types have been explored by Clifford A. Pickover, of the IBM
  2458.   Thomas J. Watson Research center. As implemented in Fractint, they are
  2459.   regular Mandelbrot/Julia set pairs that may be plotted with or without
  2460.   the "biomorph" (p. 78) option Pickover used to create organic-looking
  2461.  
  2462.                       Fractint Version 19.2                        Page 46
  2463.  
  2464.   beasties (see below). These types are produced with formulas built from
  2465.   the functions z^z, z^n, sin(z), and e^z for complex z. Types with
  2466.   "power" or "pwr" in their name have an exponent value as a third
  2467.   parameter. For example, type=manzpower params=0/0/2 is our old friend
  2468.   the classical Mandelbrot, and type=manzpower params=0/0/4 is the Quartic
  2469.   Mandelbrot. Other values of the exponent give still other fractals.
  2470.   Since these WERE the original "biomorph" types, we should give an
  2471.   example.  Try:
  2472.  
  2473.       FRACTINT type=manfn+zsqrd biomorph=0 corners=-8/8/-6/6 function=sin
  2474.  
  2475.   to see a big biomorph digesting little biomorphs!
  2476.  
  2477.  
  2478.  2.20 Pickover Popcorn
  2479.  
  2480.   (type=popcorn/popcornjul)
  2481.  
  2482.   Here is another Pickover idea. This one computes and plots the orbits of
  2483.   the dynamic system defined by:
  2484.  
  2485.            x(n+1) = x(n) - h*sin(y(n)+tan(3*y(n))
  2486.            y(n+1) = y(n) - h*sin(x(n)+tan(3*x(n))
  2487.  
  2488.   with the initializers x(0) and y(0) equal to ALL the complex values
  2489.   within the "corners" values, and h=.01.  ALL these orbits are
  2490.   superimposed, resulting in "popcorn" effect.  You may want to use a
  2491.   maxiter value less than normal - Pickover recommends a value of 50.  As
  2492.   a bonus, type=popcornjul shows the Julia set generated by these same
  2493.   equations with the usual escape-time coloring. Turn on orbit viewing
  2494.   with the "O" command, and as you watch the orbit pattern you may get
  2495.   some insight as to where the popcorn comes from. Although you can zoom
  2496.   and rotate popcorn, the results may not be what you'd expect, due to the
  2497.   superimposing of orbits and arbitrary use of color. Just for fun we
  2498.   added type popcornjul, which is the plain old Julia set calculated from
  2499.   the same formula.
  2500.  
  2501.  
  2502.  2.21 Peterson Variations
  2503.  
  2504.   (type=marksmandel, marksjulia, cmplxmarksmand, cmplxmarksjul,
  2505.   marksmandelpwr, tim's_error)
  2506.  
  2507.   These fractal types are contributions of Mark Peterson. MarksMandel and
  2508.   MarksJulia are two families of fractal types that are linked in the same
  2509.   manner as the classic Mandelbrot/Julia sets: each MarksMandel set can be
  2510.   considered as a mapping into the MarksJulia sets, and is linked with the
  2511.   spacebar toggle. The basic equation for these sets is:
  2512.         Z(n+1) = ((lambda^exp-1) * Z(n)^2) + lambda where Z(0) = 0.0 and
  2513.   lambda is (x + iy) for MarksMandel. For MarksJulia, Z(0) = (x + iy) and
  2514.   lambda is a constant (taken from the MarksMandel spacebar toggle, if
  2515.   that method is used). The exponent is a positive integer or a complex
  2516.   number. We call these "families" because each value of the exponent
  2517.   yields a different MarksMandel set, which turns out to be a kinda-
  2518.   polygon with (exponent) sides. The exponent value is the third
  2519.   parameter, after the "initialization warping" values. Typically one
  2520.  
  2521.                       Fractint Version 19.2                        Page 47
  2522.  
  2523.   would use null warping values, and specify the exponent with something
  2524.   like "PARAMS=0/0/5", which creates an unwarped, pentagonal MarksMandel
  2525.   set.
  2526.  
  2527.   In the process of coding MarksMandelPwr formula type, Tim Wegner created
  2528.   the type "tim's_error" after making an interesting coding mistake.
  2529.  
  2530.  
  2531.  2.22 Unity
  2532.  
  2533.   (type=unity)
  2534.  
  2535.   This Peterson variation began with curiosity about other "Newton-style"
  2536.   approximation processes. A simple one,
  2537.  
  2538.      One = (x * x) + (y * y); y = (2 - One) * x;   x = (2 - One) * y;
  2539.  
  2540.   produces the fractal called Unity.
  2541.  
  2542.   One of its interesting features is the "ghost lines." The iteration loop
  2543.   bails out when it reaches the number 1 to within the resolution of a
  2544.   screen pixel. When you zoom a section of the image, the bailout
  2545.   criterion is adjusted, causing some lines to become thinner and others
  2546.   thicker.
  2547.  
  2548.   Only one line in Unity that forms a perfect circle: the one at a radius
  2549.   of 1 from the origin. This line is actually infinitely thin. Zooming on
  2550.   it reveals only a thinner line, up (down?) to the limit of accuracy for
  2551.   the algorithm. The same thing happens with other lines in the fractal,
  2552.   such as those around |x| = |y| = (1/2)^(1/2) = .7071
  2553.  
  2554.   Try some other tortuous approximations using the TEST stub (p. 54) and
  2555.   let us know what you come up with!
  2556.  
  2557.  
  2558.  2.23 Scott Taylor / Lee Skinner Variations
  2559.  
  2560.   (type=fn(z*z), fn*fn, fn*z+z, fn+fn, fn+fn(pix), sqr(1/fn), sqr(fn),
  2561.   spider, tetrate, manowar)
  2562.  
  2563.   Two of Fractint's faithful users went bonkers when we introduced the
  2564.   "formula" type, and came up with all kinds of variations on escape-time
  2565.   fractals using trig functions.  We decided to put them in as regular
  2566.   types, but there were just too many! So we defined the types with
  2567.   variable functions and let you, the overwhelmed user, specify what the
  2568.   functions should be! Thus Scott Taylor's "z = sin(z) + z^2" formula type
  2569.   is now the "fn+fn" regular type, and EITHER function can be one of sin,
  2570.   cos, tan, cotan, sinh, cosh, tanh, cotanh, exp, log, sqr, recip, ident,
  2571.   conj, flip, cosxx, asin, asinh, acos, acosh, atan, atanh, sqrt, abs, or
  2572.   cabs.
  2573.  
  2574.   Plus we give you 4 parameters to set, the complex coefficients of the
  2575.   two functions!  Thus the innocent-looking "fn+fn" type is really 256
  2576.   different types in disguise, not counting the damage done by the
  2577.   parameters!
  2578.  
  2579.                       Fractint Version 19.2                        Page 48
  2580.  
  2581.    Some functions that require further explanation:
  2582.  
  2583.    conj()   - returns the complex conjugate of the argument. That is,
  2584.    changes
  2585.               sign of the imaginary component of argument: (x,y) becomes (x,-y)
  2586.    ident()  - identity function. Leaves the value of the argument
  2587.    unchanged,
  2588.               acting like a "z" term in a formula.
  2589.    flip()   - Swap the real and imaginary components of the complex
  2590.    number.
  2591.               e.g. (4,5) would become (5,4)
  2592.  
  2593.   Lee informs us that you should not judge fractals by their "outer"
  2594.   appearance. For example, the images produced by z = sin(z) + z^2 and z =
  2595.   sin(z) - z^2 look very similar, but are different when you zoom in.
  2596.  
  2597.  
  2598.  2.24 Kam Torus
  2599.  
  2600.   (type=kamtorus, kamtorus3d)
  2601.  
  2602.   This type is created by superimposing orbits generated by a set of
  2603.   equations, with a variable incremented each time.
  2604.  
  2605.            x(0) = y(0) = orbit/3;
  2606.            x(n+1) = x(n)*cos(a) + (x(n)*x(n)-y(n))*sin(a)
  2607.            y(n+1) = x(n)*sin(a) - (x(n)*x(n)-y(n))*cos(a)
  2608.  
  2609.   After each orbit, 'orbit' is incremented by a step size. The parameters
  2610.   are angle "a", step size for incrementing 'orbit', stop value for
  2611.   'orbit', and points per orbit. Try this with a stop value of 5 with
  2612.   sound=x for some weird fractal music (ok, ok, fractal noise)! You will
  2613.   also see the KAM Torus head into some chaotic territory that Scott
  2614.   Taylor wanted to hide from you by setting the defaults the way he did,
  2615.   but now we have revealed all!
  2616.  
  2617.   The 3D variant is created by treating 'orbit' as the z coordinate.
  2618.  
  2619.   With both variants, you can adjust the "maxiter" value (<X> options
  2620.   screen or parameter maxiter=) to change the number of orbits plotted.
  2621.  
  2622.  
  2623.  2.25 Bifurcation
  2624.  
  2625.   (type=bifxxx)
  2626.  
  2627.   The wonder of fractal geometry is that such complex forms can arise from
  2628.   such simple generating processes. A parallel surprise has emerged in the
  2629.   study of dynamical systems: that simple, deterministic equations can
  2630.   yield chaotic behavior, in which the system never settles down to a
  2631.   steady state or even a periodic loop. Often such systems behave normally
  2632.   up to a certain level of some controlling parameter, then go through a
  2633.   transition in which there are two possible solutions, then four, and
  2634.   finally a chaotic array of possibilities.
  2635.  
  2636.                       Fractint Version 19.2                        Page 49
  2637.  
  2638.   This emerged many years ago in biological models of population growth.
  2639.   Consider a (highly over-simplified) model in which the rate of growth is
  2640.   partly a function of the size of the current population:
  2641.  
  2642.   New Population =  Growth Rate * Old Population * (1 - Old Population)
  2643.  
  2644.   where population is normalized to be between 0 and 1. At growth rates
  2645.   less than 200 percent, this model is stable: for any starting value,
  2646.   after several generations the population settles down to a stable level.
  2647.   But for rates over 200 percent, the equation's curve splits or
  2648.   "bifurcates" into two discrete solutions, then four, and soon becomes
  2649.   chaotic.
  2650.  
  2651.   Type=bifurcation illustrates this model. (Although it's now considered a
  2652.   poor one for real populations, it helped get people thinking about
  2653.   chaotic systems.) The horizontal axis represents growth rates, from 190
  2654.   percent (far left) to 400 percent; the vertical axis normalized
  2655.   population values, from 0 to 4/3. Notice that within the chaotic region,
  2656.   there are narrow bands where there is a small, odd number of stable
  2657.   values. It turns out that the geometry of this branching is fractal;
  2658.   zoom in where changing pixel colors look suspicious, and see for
  2659.   yourself.
  2660.  
  2661.   Three parameters apply to bifurcations: Filter Cycles, Seed Population,
  2662.   and Function or Beta.
  2663.  
  2664.   Filter Cycles (default 1000) is the number of iterations to be done
  2665.   before plotting maxiter population values. This gives the iteration time
  2666.   to settle into the characteristic patterns that constitute the
  2667.   bifurcation diagram, and results in a clean-looking plot.  However,
  2668.   using lower values produces interesting results too. Set Filter Cycles
  2669.   to 1 for an unfiltered map.
  2670.  
  2671.   Seed Population (default 0.66) is the initial population value from
  2672.   which all others are calculated. For filtered maps the final image is
  2673.   independent of Seed Population value in the valid range (0.0 < Seed
  2674.   Population < 1.0).
  2675.   Seed Population becomes effective in unfiltered maps - try setting
  2676.   Filter Cycles to 1 (unfiltered) and Seed Population to 0.001
  2677.   ("PARAMS=1/.001" on the command line). This results in a map overlaid
  2678.   with nice curves. Each Seed Population value results in a different set
  2679.   of curves.
  2680.  
  2681.   Function (default "ident") is the function applied to the old population
  2682.   before the new population is determined. The "ident" function calculates
  2683.   the same bifurcation fractal that was generated before these formulae
  2684.   were generalized.
  2685.  
  2686.   Beta is used in the bifmay bifurcations and is the power to which the
  2687.   denominator is raised.
  2688.  
  2689.   Note that fractint normally uses periodicity checking to speed up
  2690.   bifurcation computation.  However, in some cases a better quality image
  2691.   will be obtained if you turn off periodicity checking with
  2692.   "periodicity=no"; for instance, if you use a high number of iterations
  2693.   and a smooth colormap.
  2694.  
  2695.                       Fractint Version 19.2                        Page 50
  2696.  
  2697.   Many formulae can be used to produce bifurcations.  Mitchel Feigenbaum
  2698.   studied lots of bifurcations in the mid-70's, using a HP-65 calculator
  2699.   (IBM PCs, Fractals, and Fractint, were all Sci-Fi then !). He studied
  2700.   where bifurcations occurred, for the formula r*p*(1-p), the one
  2701.   described above.  He found that the ratios of lengths of adjacent areas
  2702.   of bifurcation were four and a bit.  These ratios vary, but, as the
  2703.   growth rate increases, they tend to a limit of 4.669+.  This helped him
  2704.   guess where bifurcation points would be, and saved lots of time.
  2705.  
  2706.   When he studied bifurcations of r*sin(PI*p) he found a similar pattern,
  2707.   which is not surprising in itself.  However, 4.669+ popped out, again.
  2708.   Different formulae, same number ?  Now, THAT's surprising !  He tried
  2709.   many other formulae and ALWAYS got 4.669+ - Hot Damn !!!  So hot, in
  2710.   fact, that he phoned home and told his Mom it would make him Famous ! He
  2711.   also went on to tell other scientists.  The rest is History...
  2712.  
  2713.   (It has been conjectured that if Feigenbaum had a copy of Fractint, and
  2714.   used it to study bifurcations, he may never have found his Number, as it
  2715.   only became obvious from long perusal of hand-written lists of values,
  2716.   without the distraction of wild color-cycling effects !).
  2717.   We now know that this number is as universal as PI or E. It appears in
  2718.   situations ranging from fluid-flow turbulence, electronic oscillators,
  2719.   chemical reactions, and even the Mandelbrot Set - yup, fraid so:
  2720.   "budding" of the Mandelbrot Set along the negative real axis occurs at
  2721.   intervals determined by Feigenbaum's Number, 4.669201660910.....
  2722.  
  2723.   Fractint does not make direct use of the Feigenbaum Number (YET !).
  2724.   However, it does now reflect the fact that there is a whole sub-species
  2725.   of Bifurcation-type fractals.  Those implemented to date, and the
  2726.   related formulae, (writing P for pop[n+1] and p for pop[n]) are :
  2727.  
  2728.     bifurcation  P =  p + r*fn(p)*(1-fn(p))  Verhulst Bifurcations.
  2729.     biflambda    P =      r*fn(p)*(1-fn(p))  Real equivalent of Lambda
  2730.     Sets.
  2731.     bif+sinpi    P =  p + r*fn(PI*p)         Population scenario based
  2732.     on...
  2733.     bif=sinpi    P =      r*fn(PI*p)         ...Feigenbaum's second
  2734.     formula.
  2735.     bifstewart   P =      r*fn(p)*fn(p) - 1  Stewart Map.
  2736.     bifmay       P =      r*p / ((1+p)^b)    May Map.
  2737.  
  2738.   It took a while for bifurcations to appear here, despite them being over
  2739.   a century old, and intimately related to chaotic systems. However, they
  2740.   are now truly alive and well in Fractint!
  2741.  
  2742.  
  2743.  2.26 Orbit Fractals
  2744.  
  2745.   Orbit Fractals are generated by plotting an orbit path in two or three
  2746.   dimensional space.
  2747.  
  2748.   See Lorenz Attractors (p. 51), Rossler Attractors (p. 52), Henon
  2749.   Attractors (p. 52), Pickover Attractors (p. 53), Gingerbreadman
  2750.   (p. 53), and Martin Attractors (p. 53).
  2751.  
  2752.                       Fractint Version 19.2                        Page 51
  2753.  
  2754.   The orbit trajectory for these types can be saved in the file ORBITS.RAW
  2755.   by invoking Fractint with the "orbitsave=yes" command-line option.  This
  2756.   file will be overwritten each time you generate a new fractal, so rename
  2757.   it if you want to save it.  A nifty program called Acrospin can read
  2758.   these files and rapidly rotate them in 3-D - see Acrospin (p. 171).
  2759.  
  2760.  
  2761.  2.27 Lorenz Attractors
  2762.  
  2763.   (type=lorenz/lorenz3d)
  2764.  
  2765.   The "Lorenz Attractor" is a "simple" set of three deterministic
  2766.   equations developed by Edward Lorenz while studying the non-
  2767.   repeatability of weather patterns.  The weather forecaster's basic
  2768.   problem is that even very tiny changes in initial patterns ("the beating
  2769.   of a butterfly's wings" - the official term is "sensitive dependence on
  2770.   initial conditions") eventually reduces the best weather forecast to
  2771.   rubble.
  2772.  
  2773.   The lorenz attractor is the plot of the orbit of a dynamic system
  2774.   consisting of three first order non-linear differential equations. The
  2775.   solution to the differential equation is vector-valued function of one
  2776.   variable.  If you think of the variable as time, the solution traces an
  2777.   orbit.  The orbit is made up of two spirals at an angle to each other in
  2778.   three dimensions. We change the orbit color as time goes on to add a
  2779.   little dazzle to the image.  The equations are:
  2780.  
  2781.                   dx/dt = -a*x + a*y
  2782.                   dy/dt =  b*x - y   -z*x
  2783.                   dz/dt = -c*z + x*y
  2784.  
  2785.   We solve these differential equations approximately using a method known
  2786.   as the first order taylor series.  Calculus teachers everywhere will
  2787.   kill us for saying this, but you treat the notation for the derivative
  2788.   dx/dt as though it really is a fraction, with "dx" the small change in x
  2789.   that happens when the time changes "dt".  So multiply through the above
  2790.   equations by dt, and you will have the change in the orbit for a small
  2791.   time step. We add these changes to the old vector to get the new vector
  2792.   after one step. This gives us:
  2793.  
  2794.                xnew = x + (-a*x*dt) + (a*y*dt)
  2795.                ynew = y + (b*x*dt) - (y*dt) - (z*x*dt)
  2796.                znew = z + (-c*z*dt) + (x*y*dt)
  2797.  
  2798.                (default values: dt = .02, a = 5, b = 15, c = 1)
  2799.  
  2800.   We connect the successive points with a line, project the resulting 3D
  2801.   orbit onto the screen, and voila! The Lorenz Attractor!
  2802.  
  2803.   We have added two versions of the Lorenz Attractor.  "Type=lorenz" is
  2804.   the Lorenz attractor as seen in everyday 2D.  "Type=lorenz3d" is the
  2805.   same set of equations with the added twist that the results are run
  2806.   through our perspective 3D routines, so that you get to view it from
  2807.   different angles (you can modify your perspective "on the fly" by using
  2808.   the <I> command.)  If you set the "stereo" option to "2", and have
  2809.   red/blue funny glasses on, you will see the attractor orbit with depth
  2810.  
  2811.                       Fractint Version 19.2                        Page 52
  2812.  
  2813.   perception.
  2814.  
  2815.   Hint: the default perspective values (x = 60, y = 30, z = 0) aren't the
  2816.   best ones to use for fun Lorenz Attractor viewing.  Experiment a bit -
  2817.   start with rotation values of 0/0/0 and then change to 20/0/0 and 40/0/0
  2818.   to see the attractor from different angles.- and while you're at it, use
  2819.   a non-zero perspective point Try 100 and see what happens when you get
  2820.   *inside* the Lorenz orbits.  Here comes one - Duck!  While you are at
  2821.   it, turn on the sound with the "X". This way you'll at least hear it
  2822.   coming!
  2823.  
  2824.   Different Lorenz attractors can be created using different parameters.
  2825.   Four parameters are used. The first is the time-step (dt). The default
  2826.   value is .02. A smaller value makes the plotting go slower; a larger
  2827.   value is faster but rougher. A line is drawn to connect successive orbit
  2828.   values.  The 2nd, third, and fourth parameters are coefficients used in
  2829.   the differential equation (a, b, and c). The default values are 5, 15,
  2830.   and 1.  Try changing these a little at a time to see the result.
  2831.  
  2832.  
  2833.  2.28 Rossler Attractors
  2834.  
  2835.   (type=rossler3D)
  2836.  
  2837.   This fractal is named after the German Otto Rossler, a non-practicing
  2838.   medical doctor who approached chaos with a bemusedly philosophical
  2839.   attitude.  He would see strange attractors as philosophical objects. His
  2840.   fractal namesake looks like a band of ribbon with a fold in it. All we
  2841.   can say is we used the same calculus-teacher-defeating trick of
  2842.   multiplying the equations by "dt" to solve the differential equation and
  2843.   generate the orbit.  This time we will skip straight to the orbit
  2844.   generator - if you followed what we did above with type Lorenz (p. 51)
  2845.   you can easily reverse engineer the differential equations.
  2846.  
  2847.                xnew = x - y*dt -   z*dt
  2848.                ynew = y + x*dt + a*y*dt
  2849.                znew = z + b*dt + x*z*dt - c*z*dt
  2850.  
  2851.   Default parameters are dt = .04, a = .2, b = .2, c = 5.7
  2852.  
  2853.  
  2854.  2.29 Henon Attractors
  2855.  
  2856.   (type=henon)
  2857.  
  2858.   Michel Henon was an astronomer at Nice observatory in southern France.
  2859.   He came to the subject of fractals via investigations of the orbits of
  2860.   astronomical objects.  The strange attractor most often linked with
  2861.   Henon's name comes not from a differential equation, but from the world
  2862.   of discrete mathematics - difference equations. The Henon map is an
  2863.   example of a very simple dynamic system that exhibits strange behavior.
  2864.   The orbit traces out a characteristic banana shape, but on close
  2865.   inspection, the shape is made up of thicker and thinner parts.  Upon
  2866.   magnification, the thicker bands resolve to still other thick and thin
  2867.   components.  And so it goes forever! The equations that generate this
  2868.   strange pattern perform the mathematical equivalent of repeated
  2869.  
  2870.                       Fractint Version 19.2                        Page 53
  2871.  
  2872.   stretching and folding, over and over again.
  2873.  
  2874.                xnew =  1 + y - a*x*x
  2875.                ynew =  b*x
  2876.  
  2877.   The default parameters are a=1.4 and b=.3.
  2878.  
  2879.  
  2880.  2.30 Pickover Attractors
  2881.  
  2882.   (type=pickover)
  2883.  
  2884.   Clifford A. Pickover of the IBM Thomas J. Watson Research center is such
  2885.   a creative source for fractals that we attach his name to this one only
  2886.   with great trepidation.  Probably tomorrow he'll come up with another
  2887.   one and we'll be back to square one trying to figure out a name!
  2888.  
  2889.   This one is the three dimensional orbit defined by:
  2890.  
  2891.                xnew = sin(a*y) - z*cos(b*x)
  2892.                ynew = z*sin(c*x) - cos(d*y)
  2893.                znew = sin(x)
  2894.  
  2895.   Default parameters are: a = 2.24, b = .43, c = -.65, d = -2.43
  2896.  
  2897.  
  2898.  2.31 Gingerbreadman
  2899.  
  2900.   (type=gingerbreadman)
  2901.  
  2902.   This simple fractal is a charming example stolen from "Science of
  2903.   Fractal Images", p. 149.
  2904.  
  2905.                xnew = 1 - y + |x|
  2906.                ynew = x
  2907.  
  2908.   The initial x and y values are set by parameters, defaults x=-.1, y = 0.
  2909.  
  2910.  
  2911.  2.32 Martin Attractors
  2912.  
  2913.   (type=hopalong/martin)
  2914.  
  2915.   These fractal types are from A. K. Dewdney's "Computer Recreations"
  2916.   column in "Scientific American". They are attributed to Barry Martin of
  2917.   Aston University in Birmingham, England.
  2918.  
  2919.   Hopalong is an "orbit" type fractal like lorenz. The image is obtained
  2920.   by iterating this formula after setting z(0) = y(0) = 0:
  2921.         x(n+1) = y(n) - sign(x(n))*sqrt(abs(b*x(n)-c))
  2922.         y(n+1) = a - x(n)
  2923.   Parameters are a, b, and c. The function "sign()"  returns 1 if the
  2924.   argument is positive, -1 if argument is negative.
  2925.  
  2926.                       Fractint Version 19.2                        Page 54
  2927.  
  2928.   This fractal continues to develop in surprising ways after many
  2929.   iterations.
  2930.  
  2931.   Another Martin fractal is simpler. The iterated formula is:
  2932.         x(n+1) = y(n) - sin(x(n))
  2933.         y(n+1) = a - x(n)
  2934.   The parameter is "a". Try values near the number pi.
  2935.  
  2936.   Michael Peters has based the HOP program on variations of these Martin
  2937.   types.  You will find three of these here: chip, quadruptwo, and
  2938.   threeply.
  2939.  
  2940.  
  2941.  2.33 Icon
  2942.  
  2943.   (type=icon/icon3d)
  2944.  
  2945.     This fractal type was inspired by the book "Symmetry in Chaos" by
  2946.     Michael Field and Martin Golubitsky (ISBN 0-19-853689-5, Oxford Press)
  2947.  
  2948.     To quote from the book's jacket,
  2949.  
  2950.       "Field and Golubitsky describe how a chaotic process eventually can
  2951.       lead to symmetric patterns (in a river, for instance, photographs of
  2952.       the turbulent movement of eddies, taken over time, often reveal
  2953.       patterns on the average."
  2954.  
  2955.     The Icon type implemented here maps the classic population logistic
  2956.     map of bifurcation fractals onto the complex plane in Dn symmetry.
  2957.  
  2958.     The initial points plotted are the more chaotic initial orbits, but as
  2959.     you wait, delicate webs will begin to form as the orbits settle into a
  2960.     more periodic pattern.  Since pixels are colored by the number of
  2961.     times they are hit, the more periodic paths will become clarified with
  2962.     time.  These fractals run continuously.
  2963.  
  2964.   There are 6 parameters:  Lambda, Alpha, Beta, Gamma, Omega, and Degree
  2965.       Omega  0 = Dn, or dihedral (rotation + reflectional) symmetry
  2966.             !0 = Zn, or cyclic (rotational) symmetry
  2967.       Degree = n, or Degree of symmetry
  2968.  
  2969.  
  2970.  2.34 Test
  2971.  
  2972.   (type=test)
  2973.  
  2974.   This is a stub that we (and you!) use for trying out new fractal types.
  2975.   "Type=test" fractals make use of Fractint's structure and features for
  2976.   whatever code is in the routine 'testpt()' (located in the small source
  2977.   file TESTPT.C) to determine the color of a particular pixel.
  2978.  
  2979.   If you have a favorite fractal type that you believe would fit nicely
  2980.   into Fractint, just rewrite the C function in TESTPT.C (or use the
  2981.   prototype function there, which is a simple M-set implementation) with
  2982.   an algorithm that computes a color based on a point in the complex
  2983.   plane.
  2984.  
  2985.                       Fractint Version 19.2                        Page 55
  2986.  
  2987.   After you get it working, send your code to one of the authors and we
  2988.   might just add it to the next release of Fractint, with full credit to
  2989.   you. Our criteria are: 1) an interesting image and 2) a formula
  2990.   significantly different from types already supported. (Bribery may also
  2991.   work. THIS author is completely honest, but I don't trust those other
  2992.   guys.) Be sure to include an explanation of your algorithm and the
  2993.   parameters supported, preferably formatted as you see here to simplify
  2994.   folding it into the documentation.
  2995.  
  2996.  
  2997.  2.35 Formula
  2998.  
  2999.   (type=formula)
  3000.  
  3001.   This is a "roll-your-own" fractal interpreter - you don't even need a
  3002.   compiler!
  3003.  
  3004.   To run a "type=formula" fractal, you first need a text file containing
  3005.   formulas (there's a sample file - FRACTINT.FRM - included with this
  3006.   distribution).  When you select the "formula" fractal type, Fractint
  3007.   scans the current formula file (default is FRACTINT.FRM) for formulas,
  3008.   then prompts you for the formula name you wish to run.  After prompting
  3009.   for any parameters, the formula is parsed for syntax errors and then the
  3010.   fractal is generated. If you want to use a different formula file, press
  3011.   <F6> when you are prompted to select a formula name.
  3012.  
  3013.   There are two command-line options that work with type=formula
  3014.   ("formulafile=" and "formulaname="), useful when you are using this
  3015.   fractal type in batch mode.
  3016.  
  3017.   The following documentation is supplied by Mark Peterson, who wrote the
  3018.   formula interpreter:
  3019.  
  3020.   Formula fractals allow you to create your own fractal formulas.  The
  3021.   general format is:
  3022.  
  3023.      Mandelbrot(XAXIS) { z = Pixel:  z = sqr(z) + pixel, |z| <= 4 }
  3024.         |         |          |                |              |
  3025.        Name     Symmetry    Initial         Iteration       Bailout
  3026.                             Condition                       Criteria
  3027.  
  3028.   Initial conditions are set, then the iterations performed while the
  3029.   bailout criteria remains true or until 'z' turns into a periodic loop.
  3030.   All variables are created automatically by their usage and treated as
  3031.   complex.  If you declare 'v = 2' then the variable 'v' is treated as a
  3032.   complex with an imaginary value of zero.
  3033.  
  3034.             Predefined Variables (x, y)
  3035.             --------------------------------------------
  3036.             z          used for periodicity checking
  3037.             p1         parameters 1 and 2
  3038.             p2         parameters 3 and 4
  3039.             p3         parameters 5 and 6
  3040.             pixel      screen coordinates
  3041.             LastSqr    Modulus from the last sqr() function
  3042.             rand       Complex random number
  3043.  
  3044.                       Fractint Version 19.2                        Page 56
  3045.  
  3046.             Precedence
  3047.             --------------------------------------------
  3048.             1          sin(), cos(), sinh(), cosh(), cosxx(), tan(), cotan(),
  3049.                        tanh(), cotanh(), sqr(), log(), exp(), abs(), conj(),
  3050.                        real(), imag(), flip(), fn1(), fn2(), fn3(), fn4(),
  3051.                        srand(), asin(), asinh(), acos(), acosh(), atan(),
  3052.                        atanh(), sqrt(), cabs()
  3053.             2          - (negation), ^ (power)
  3054.             3          * (multiplication), / (division)
  3055.             4          + (addition), - (subtraction)
  3056.             5          = (assignment)
  3057.             6          < (less than), <= (less than or equal to)
  3058.                        > (greater than), >= (greater than or equal to)
  3059.                        == (equal to), != (not equal to)
  3060.             7          && (logical AND), || (logical OR)
  3061.  
  3062.   Precedence may be overridden by use of parenthesis.  Note the modulus
  3063.   squared operator |z| is also parenthetic and always sets the imaginary
  3064.   component to zero.  This means 'c * |z - 4|' first subtracts 4 from z,
  3065.   calculates the modulus squared then multiplies times 'c'.  Nested
  3066.   modulus squared operators require overriding parenthesis: c * |z +
  3067.   (|pixel|)|
  3068.  
  3069.   The functions fn1(...) to fn4(...) are variable functions - when used,
  3070.   the user is prompted at run time (on the <Z> screen) to specify one of
  3071.   sin, cos, sinh, cosh, exp, log, sqr, etc. for each required variable
  3072.   function.
  3073.  
  3074.   Most of the functions have their conventional meaning, here are a few
  3075.   notes on others that are not conventional. The function cosxx()
  3076.   duplicates a bug in the version 16 cos() function. Then abs(x+iy) =
  3077.   abs(x)+i*abs(y), flip(x+iy) = y+i*x, and |x+iy| = x*x+y*y.
  3078.  
  3079.   The formulas are performed using either integer or floating point
  3080.   mathematics depending on the <F> floating point toggle.  If you do not
  3081.   have an FPU then type MPC math is performed in lieu of traditional
  3082.   floating point.
  3083.  
  3084.   The 'rand' predefined variable is changed with each iteration to a new
  3085.   random number with the real and imaginary components containing a value
  3086.   between zero and 1. Use the srand() function to initialize the random
  3087.   numbers to a consistent random number sequence.  If a formula does not
  3088.   contain the srand() function, then the formula compiler will use the
  3089.   system time to initialize the sequence.  This could cause a different
  3090.   fractal to be generated each time the formula is used depending on how
  3091.   the formula is written.
  3092.  
  3093.   Remember that when using integer math there is a limited dynamic range,
  3094.   so what you think may be a fractal could really be just a limitation of
  3095.   the integer math range.  God may work with integers, but His dynamic
  3096.   range is many orders of magnitude greater than our puny 32 bit
  3097.   mathematics!  Always verify with the floating point <F> toggle.
  3098.  
  3099.   The possible values for symmetry are:
  3100.  
  3101.                       Fractint Version 19.2                        Page 57
  3102.  
  3103.   XAXIS,  XAXIS_NOPARM
  3104.   YAXIS,  YAXIS_NOPARM
  3105.   XYAXIS, XYAXIS_NOPARM
  3106.   ORIGIN, ORIGIN_NOPARM
  3107.   PI_SYM, PI_SYM_NOPARM
  3108.   XAXIS_NOREAL
  3109.   XAXIS_NOIMAG
  3110.  
  3111.   These will force the symmetry even if no symmetry is actually present,
  3112.   so try your formulas without symmetry before you use these.
  3113.  
  3114.   For mathematical formulas of functions used in the parser language, see
  3115.    Trig Identities (p. 154)
  3116.  
  3117.  
  3118.  2.36 Julibrots
  3119.  
  3120.   (type=julibrot)
  3121.  
  3122.   The Julibrot fractal type uses a general-purpose renderer for
  3123.   visualizing three dimensional solid fractals. Originally Mark Peterson
  3124.   developed this rendering mechanism to view a 3-D sections of a 4-D
  3125.   structure he called a "Julibrot".  This structure, also called "layered
  3126.   Julia set" in the fractal literature, hinges on the relationship between
  3127.   the Mandelbrot and Julia sets. Each Julia set is created using a fixed
  3128.   value c in the iterated formula z^2 + c. The Julibrot is created by
  3129.   layering Julia sets in the x-y plane and continuously varying c,
  3130.   creating new Julia sets as z is incremented. The solid shape thus
  3131.   created is rendered by shading the surface using a brightness inversely
  3132.   proportional to the virtual viewer's eye.
  3133.  
  3134.   Starting with Fractint version 18, the Julibrot engine can be used with
  3135.   other Julia formulas besides the classic z^2 + c. The first field on the
  3136.   Julibrot parameter screen lets you select which orbit formula to use.
  3137.  
  3138.   You can also use the Julibrot renderer to visualize 3D cross sections of
  3139.   true four dimensional Quaternion and Hypercomplex fractals.
  3140.  
  3141.   The Julibrot Parameter Screens
  3142.  
  3143.   Orbit Algorithm - select the orbit algorithm to use. The available
  3144.      possibilities include 2-D Julia and both mandelbrot and Julia
  3145.      variants of the 4-D Quaternion and Hypercomplex fractals.
  3146.  
  3147.   Orbit parameters - the next screen lets you fill in any parameters
  3148.      belonging to the orbit algorithm. This list of parameters is not
  3149.      necessarily the same as the list normally presented for the orbit
  3150.      algorithm, because some of these parameters are used in the Julibrot
  3151.      layering process.
  3152.  
  3153.      From/To Parameters These parameters allow you to specify the
  3154.      "Mandelbrot" values used to generate the layered Julias. The
  3155.      parameter c in the Julia formulas will be incremented in steps
  3156.      ranging from the "from" x and y values to the "to" x and y values. If
  3157.      the orbit formula is one of the "true" four dimensional fractal types
  3158.      quat, quatj, hypercomplex, or hypercomplexj, then these numbers are
  3159.  
  3160.                       Fractint Version 19.2                        Page 58
  3161.  
  3162.      used with the 3rd and 4th dimensional values.
  3163.  
  3164.      The "from/to" variables are different for the different kinds of
  3165.      orbit algorithm.
  3166.  
  3167.         2D Julia sets - complex number formula z' = f(z) + c
  3168.            The "from/to" parameters change the values of c.
  3169.         4D Julia sets - Quaternion or Hypercomplex formula z' = f(z) + c
  3170.            The four dimensions of c are set by the orbit parameters.
  3171.            The first two dimensions of z are determined by the corners values.
  3172.            The third and fourth dimensions of z are the "to/from" variables.
  3173.         4D Mandelbrot sets - Quaternion or Hypercomplex formula z' = f(z)
  3174.         + c
  3175.            The first two dimensions of c are determined by the corners values.
  3176.            The third and fourth dimensions of c are the "to/from" variables.
  3177.  
  3178.   Distance between the eyes - set this to 2.5 if you want a red/blue
  3179.      anaglyph image, 0 for a normal greyscale image.
  3180.  
  3181.   Number of z pixels - this sets how many layers are rendered in the
  3182.      screen z-axis. Use a higher value with higher resolution video modes.
  3183.  
  3184.   The remainder of the parameters are needed to construct the red/blue
  3185.   picture so that the fractal appears with the desired depth and proper
  3186.   'z' location.  With the origin set to 8 inches beyond the screen plane
  3187.   and the depth of the fractal at 8 inches the default fractal will appear
  3188.   to start at 4 inches beyond the screen and extend to 12 inches if your
  3189.   eyeballs are 2.5 inches apart and located at a distance of 24 inches
  3190.   from the screen.  The screen dimensions provide the reference frame.
  3191.  
  3192.  
  3193.  
  3194.  2.37 Diffusion Limited Aggregation
  3195.  
  3196.   (type=diffusion)
  3197.  
  3198.   This type begins with a single point in the center of the screen.
  3199.   Subsequent points move around randomly until coming into contact with
  3200.   the first point, at which time their locations are fixed and they are
  3201.   colored randomly.  This process repeats until the fractals reaches the
  3202.   edge of the screen.  Use the show orbits function to see the points'
  3203.   random motion.
  3204.  
  3205.   One unfortunate problem is that on a large screen, this process will
  3206.   tend to take eons.  To speed things up, the points are restricted to a
  3207.   box around the initial point.  The first and only parameter to diffusion
  3208.   contains the size of the border between the fractal and the edge of the
  3209.   box.  If you make this number small, the fractal will look more solid
  3210.   and will be generated more quickly.
  3211.  
  3212.   Diffusion was inspired by a Scientific American article a couple of
  3213.   years back which includes actual pictures of real physical phenomena
  3214.   that behave like this.
  3215.  
  3216.                       Fractint Version 19.2                        Page 59
  3217.  
  3218.   Thanks to Adrian Mariano for providing the diffusion code and
  3219.   documentation. Juan J. Buhler added the additional options.
  3220.  
  3221.  
  3222.  2.38 Magnetic Fractals
  3223.  
  3224.   (type=magnet1m/.../magnet2j)
  3225.  
  3226.   These fractals use formulae derived from the study of hierarchical
  3227.   lattices, in the context of magnetic renormalisation transformations.
  3228.   This kinda stuff is useful in an area of theoretical physics that deals
  3229.   with magnetic phase-transitions (predicting at which temperatures a
  3230.   given substance will be magnetic, or non-magnetic).  In an attempt to
  3231.   clarify the results obtained for Real temperatures (the kind that you
  3232.   and I can feel), the study moved into the realm of Complex Numbers,
  3233.   aiming to spot Real phase-transitions by finding the intersections of
  3234.   lines representing Complex phase-transitions with the Real Axis.  The
  3235.   first people to try this were two physicists called Yang and Lee, who
  3236.   found the situation a bit more complex than first expected, as the phase
  3237.   boundaries for Complex temperatures are (surprise!) fractals.
  3238.  
  3239.   And that's all the technical (?) background you're getting here!  For
  3240.   more details (are you SERIOUS ?!) read "The Beauty of Fractals".  When
  3241.   you understand it all, you might like to rewrite this section, before
  3242.   you start your new job as a professor of theoretical physics...
  3243.  
  3244.   In Fractint terms, the important bits of the above are "Fractals",
  3245.   "Complex Numbers", "Formulae", and "The Beauty of Fractals".  Lifting
  3246.   the Formulae straight out of the Book and iterating them over the
  3247.   Complex plane (just like the Mandelbrot set) produces Fractals.
  3248.  
  3249.   The formulae are a bit more complicated than the Z^2+C used for the
  3250.   Mandelbrot Set, that's all.  They are :
  3251.  
  3252.                     [               ] 2
  3253.                     |  Z^2 + (C-1)  |
  3254.           MAGNET1 : | ------------- |
  3255.                     |  2*Z + (C-2)  |
  3256.                     [               ]
  3257.  
  3258.                     [                                         ] 2
  3259.                     |      Z^3 + 3*(C-1)*Z + (C-1)*(C-2)      |
  3260.           MAGNET2 : | --------------------------------------- |
  3261.                     |  3*(Z^2) + 3*(C-2)*Z + (C-1)*(C-2) + 1  |
  3262.                     [                                         ]
  3263.  
  3264.   These aren't quite as horrific as they look (oh yeah ?!) as they only
  3265.   involve two variables (Z and C), but cubing things, doing division, and
  3266.   eventually squaring the result (all in Complex Numbers) don't exactly
  3267.   spell S-p-e-e-d !  These are NOT the fastest fractals in Fractint !
  3268.  
  3269.   As you might expect, for both formulae there is a single related
  3270.   Mandelbrot-type set (magnet1m, magnet2m) and an infinite number of
  3271.   related Julia-type sets (magnet1j, magnet2j), with the usual toggle
  3272.   between the corresponding Ms and Js via the spacebar.
  3273.  
  3274.                       Fractint Version 19.2                        Page 60
  3275.  
  3276.   If you fancy delving into the Julia-types by hand, you will be prompted
  3277.   for the Real and Imaginary parts of the parameter denoted by C.  The
  3278.   result is symmetrical about the Real axis (and therefore the initial
  3279.   image gets drawn in half the usual time) if you specify a value of Zero
  3280.   for the Imaginary part of C.
  3281.  
  3282.   Fractint Historical Note:  Another complication (besides the formulae)
  3283.   in implementing these fractal types was that they all have a finite
  3284.   attractor (1.0 + 0.0i), as well as the usual one (Infinity).  This fact
  3285.   spurred the development of Finite Attractor logic in Fractint.  Without
  3286.   this code you can still generate these fractals, but you usually end up
  3287.   with a pretty boring image that is mostly deep blue "lake", courtesy of
  3288.   Fractint's standard Periodicity Logic (p. 134).  See Finite Attractors
  3289.   (p. 152) for more information on this aspect of Fractint internals.
  3290.  
  3291.   (Thanks to Kevin Allen for Magnetic type documentation above).
  3292.  
  3293.  
  3294.  2.39 L-Systems
  3295.  
  3296.   (type=lsystem)
  3297.  
  3298.   These fractals are constructed from line segments using rules specified
  3299.   in drawing commands.  Starting with an initial string, the axiom,
  3300.   transformation rules are applied a specified number of times, to produce
  3301.   the final command string which is used to draw the image.
  3302.  
  3303.   Like the type=formula fractals, this type requires a separate data file.
  3304.   A sample file, FRACTINT.L, is included with this distribution.  When you
  3305.   select type lsystem, the current lsystem file is read and you are asked
  3306.   for the lsystem name you wish to run. Press <F6> at this point if you
  3307.   wish to use a different lsystem file. After selecting an lsystem, you
  3308.   are asked for one parameter - the "order", or number of times to execute
  3309.   all the transformation rules.  It is wise to start with small orders,
  3310.   because the size of the substituted command string grows exponentially
  3311.   and it is very easy to exceed your resolution.  (Higher orders take
  3312.   longer to generate too.)  The command line options "lname=" and "lfile="
  3313.   can be used to over-ride the default file name and lsystem name.
  3314.  
  3315.   Each L-System entry in the file contains a specification of the angle,
  3316.   the axiom, and the transformation rules.  Each item must appear on its
  3317.   own line and each line must be less than 160 characters long.
  3318.  
  3319.   The statement "angle n" sets the angle to 360/n degrees; n must be an
  3320.   integer greater than two and less than fifty.
  3321.  
  3322.   "Axiom string" defines the axiom.
  3323.  
  3324.   Transformation rules are specified as "a=string" and convert the single
  3325.   character 'a' into "string."  If more than one rule is specified for a
  3326.   single character all of the strings will be added together.  This allows
  3327.   specifying transformations longer than the 160 character limit.
  3328.   Transformation rules may operate on any characters except space, tab or
  3329.   '}'.
  3330.  
  3331.                       Fractint Version 19.2                        Page 61
  3332.  
  3333.   Any information after a ; (semi-colon) on a line is treated as a
  3334.   comment.
  3335.  
  3336.   Here is a sample lsystem:
  3337.  
  3338.   Dragon {         ; Name of lsystem, { indicates start
  3339.     Angle 8        ; Specify the angle increment to 45 degrees
  3340.     Axiom FX       ; Starting character string
  3341.     F=             ; First rule:  Delete 'F'
  3342.     y=+FX--FY+     ; Change 'y' into  "+fx--fy+"
  3343.     x=-FX++FY-     ; Similar transformation on 'x'
  3344.   }                ; final } indicates end
  3345.  
  3346.   The standard drawing commands are:
  3347.       F Draw forward
  3348.       G Move forward (without drawing)
  3349.       + Increase angle
  3350.       - Decrease angle
  3351.       | Try to turn 180 degrees. (If angle is odd, the turn
  3352.         will be the largest possible turn less than 180 degrees.)
  3353.  
  3354.   These commands increment angle by the user specified angle value. They
  3355.   should be used when possible because they are fast. If greater
  3356.   flexibility is needed, use the following commands which keep a
  3357.   completely separate angle pointer which is specified in degrees.
  3358.  
  3359.       D   Draw forward
  3360.       M   Move forward
  3361.       \nn Increase angle nn degrees
  3362.       /nn Decrease angle nn degrees
  3363.  
  3364.   Color control:
  3365.       Cnn Select color nn
  3366.       <nn Increment color by nn
  3367.       >nn decrement color by nn
  3368.  
  3369.   Advanced commands:
  3370.       !     Reverse directions (Switch meanings of +, - and , /)
  3371.       @nnn  Multiply line segment size by nnn
  3372.             nnn may be a plain number, or may be preceded by
  3373.                 I for inverse, or Q for square root.
  3374.                 (e.g.  @IQ2 divides size by the square root of 2)
  3375.       [     Push.  Stores current angle and position on a stack
  3376.       ]     Pop.  Return to location of last push
  3377.  
  3378.   Other characters are perfectly legal in command strings.  They are
  3379.   ignored for drawing purposes, but can be used to achieve complex
  3380.   translations.
  3381.  
  3382.   The characters '+', '-', '<', '>', '[', ']', '|', '!', '@', '/', '\',
  3383.   and 'c' are reserved symbols and cannot be redefined.  For example,
  3384.   c=f+f and <= , are syntax errors.
  3385.  
  3386.   The integer code produces incorrect results in five known instances,
  3387.   Peano2 with order >= 7, SnowFlake1 with order >=6, and SnowFlake2,
  3388.   SnowFlake3, and SnowflakeColor with order >= 5.  If you see strange
  3389.  
  3390.                       Fractint Version 19.2                        Page 62
  3391.  
  3392.   results, switch to the floating point code.
  3393.  
  3394.  
  3395.  2.40 Lyapunov Fractals
  3396.  
  3397.   (type=lyapunov)
  3398.  
  3399.   The Bifurcation fractal illustrates what happens in a simple population
  3400.   model as the growth rate increases.  The Lyapunov fractal expands that
  3401.   model into two dimensions by letting the growth rate vary in a periodic
  3402.   fashion between two values.  Each pair of growth rates is run through a
  3403.   logistic population model and a value called the Lyapunov Exponent is
  3404.   calculated for each pair and is plotted. The Lyapunov Exponent is
  3405.   calculated by adding up log | r - 2*r*x| over many cycles of the
  3406.   population model and dividing by the number of cycles. Negative Lyapunov
  3407.   exponents indicate a stable, periodic behavior and are plotted in color.
  3408.   Positive Lyapunov exponents indicate chaos (or a diverging model) and
  3409.   are colored black.
  3410.  
  3411.   Order parameter.  Each possible periodic sequence yields a two
  3412.   dimensional space to explore.  The Order parameter selects a sequence.
  3413.   The default value 0 represents the sequence ab which alternates between
  3414.   the two values of the growth parameter.  On the screen, the a values run
  3415.   vertically and the b values run horizontally. Here is how to calculate
  3416.   the space parameter for any desired sequence.  Take your sequence of a's
  3417.   and b's and arrange it so that it starts with at least 2 a's and ends
  3418.   with a b. It may be necessary to rotate the sequence or swap a's and
  3419.   b's. Strike the first a and the last b off the list and replace each
  3420.   remaining a with a 1 and each remaining b with a zero.  Interpret this
  3421.   as a binary number and convert it into decimal.
  3422.  
  3423.   An Example.  I like sonnets.  A sonnet is a poem with fourteen lines
  3424.   that has the following rhyming sequence: abba abba abab cc.  Ignoring
  3425.   the rhyming couplet at the end, let's calculate the Order parameter for
  3426.   this pattern.
  3427.  
  3428.     abbaabbaabab         doesn't start with at least 2 a's
  3429.     aabbaabababb         rotate it
  3430.     1001101010           drop the first and last, replace with 0's and 1's
  3431.  
  3432.     512+64+32+8+2 = 618
  3433.  
  3434.   An Order parameter of 618 gives the Lyapunov equivalent of a sonnet.
  3435.   "How do I make thee? Let me count the ways..."
  3436.  
  3437.   Population Seed.  When two parts of a Lyapunov overlap, which spike
  3438.   overlaps which is strongly dependent on the initial value of the
  3439.   population model.  Any changes from using a different starting value
  3440.   between 0 and 1 may be subtle. The values 0 and 1 are interpreted in a
  3441.   special manner. A Seed of 1 will choose a random number between 0 and 1
  3442.   at the start of each pixel. A Seed of 0 will suppress resetting the seed
  3443.   value between pixels unless the population model diverges in which case
  3444.   a random seed will be used on the next pixel.
  3445.  
  3446.                       Fractint Version 19.2                        Page 63
  3447.  
  3448.   Filter Cycles.  Like the Bifurcation model, the Lyapunov allow you to
  3449.   set the number of cycles that will be run to allow the model to approach
  3450.   equilibrium before the lyapunov exponent calculation is begun. The
  3451.   default value of 0 uses one half of the iterations before beginning the
  3452.   calculation of the exponent.
  3453.  
  3454.   Reference.  A.K. Dewdney, Mathematical Recreations, Scientific American,
  3455.   Sept. 1991
  3456.  
  3457.  
  3458.  2.41 fn||fn Fractals
  3459.  
  3460.   (type=lambda(fn||fn), manlam(fn||fn), julia(fn||fn), mandel(fn||fn))
  3461.  
  3462.   Two functions=[sin|cos|sinh|cosh|exp|log|sqr|...]) are specified with
  3463.   these types.  The two functions are alternately used in the calculation
  3464.   based on a comparison between the modulus of the current Z and the shift
  3465.   value.  The first function is used if the modulus of Z is less than the
  3466.   shift value and the second function is used otherwise.
  3467.  
  3468.   The lambda(fn||fn) type calculates the Julia set of the formula
  3469.   lambda*fn(Z), for various values of the function "fn", where lambda and
  3470.   Z are both complex.  Two values, the real and imaginary parts of lambda,
  3471.   should be given in the "params=" option.  The third value is the shift
  3472.   value.  The space bar will generate the corresponding "pseudo
  3473.   Mandelbrot" set, manlam(fn||fn).
  3474.  
  3475.   The manlam(fn||fn) type calculates the "pseudo Mandelbrot" set of the
  3476.   formula fn(Z)*C, for various values of the function "fn", where C and Z
  3477.   are both complex.  Two values, the real and imaginary parts of Z(0),
  3478.   should be given in the "params=" option.  The third value is the shift
  3479.   value.  The space bar will generate the corresponding julia set,
  3480.   lamda(fn||fn).
  3481.  
  3482.   The julia(fn||fn) type calculates the Julia set of the formula fn(Z)+C,
  3483.   for various values of the function "fn", where C and Z are both complex.
  3484.   Two values, the real and imaginary parts of C, should be given in the
  3485.   "params=" option.  The third value is the shift value.  The space bar
  3486.   will generate the corresponding mandelbrot set, mandel(fn||fn).
  3487.  
  3488.   The mandel(fn||fn) type calculates the Mandelbrot set of the formula
  3489.   fn(Z)+C, for various values of the function "fn", where C and Z are both
  3490.   complex.  Two values, the real and imaginary parts of Z(0), should be
  3491.   given in the "params=" option.  The third value is the shift value.  The
  3492.   space bar will generate the corresponding julia set, julia(fn||fn).
  3493.  
  3494.  
  3495.  2.42 Halley
  3496.  
  3497.   (type=halley)
  3498.  
  3499.   The Halley map is an algorithm used to find the roots of polynomial
  3500.   equations by successive "guesses" that converge on the correct value as
  3501.   you feed the results of each approximation back into the formula. It
  3502.   works very well -- unless you are unlucky enough to pick a value that is
  3503.   on a line BETWEEN two actual roots. In that case, the sequence explodes
  3504.  
  3505.                       Fractint Version 19.2                        Page 64
  3506.  
  3507.   into chaos, with results that diverge more and more wildly as you
  3508.   continue the iteration.
  3509.  
  3510.   This fractal type shows the results for the polynomial Z(Z^a - 1), which
  3511.   has a+1 roots in the complex plane. Use the <T>ype command and enter
  3512.   "halley" in response to the prompt. You will be asked for a parameter,
  3513.   the "order" of the equation (an integer from 2 through 10 -- 2 for Z(Z^2
  3514.   - 1), 7 for Z(Z^7 - 1), etc.). A second parameter is the relaxation
  3515.   coefficient, and is used to control the convergence stability. A number
  3516.   greater than one increases the chaotic behavior and a number less than
  3517.   one decreases the chaotic behavior. The third parameter is the value
  3518.   used to determine when the formula has converged. The test for
  3519.   convergence is ||Z(n+1)|^2 - |Z(n)|^2| < epsilon. This convergence test
  3520.   produces the whisker-like projections which generally point to a root.
  3521.  
  3522.  
  3523.  2.43 Dynamic System
  3524.  
  3525.   (type=dynamic, dynamic2)
  3526.  
  3527.   These fractals are based on a cyclic system of differential equations:
  3528.            x'(t) = -f(y(t))
  3529.            y'(t) = f(x(t))
  3530.   These equations are approximated by using a small time step dt, forming
  3531.   a time-discrete dynamic system:
  3532.            x(n+1) = x(n) - dt*f(y(n))
  3533.            y(n+1) = y(n) + dt*f(x(n))
  3534.   The initial values x(0) and y(0) are set to various points in the plane,
  3535.   the dynamic system is iterated, and the resulting orbit points are
  3536.   plotted.
  3537.  
  3538.   In fractint, the function f is restricted to: f(k) = sin(k + a*fn1(b*k))
  3539.   The parameters are the spacing of the initial points, the time step dt,
  3540.   and the parameters (a,b,fn1) that affect the function f.  Normally the
  3541.   orbit points are plotted individually, but for a negative spacing the
  3542.   points are connected.
  3543.  
  3544.   This fractal is similar to the Pickover Popcorn (p. 46).
  3545.   A variant is the implicit Euler approximation:
  3546.            y(n+1) = y(n) + dt*f(x(n))
  3547.            x(n+1) = x(n) - dt*f(y(n+1))
  3548.   This variant results in complex orbits.  The implicit Euler
  3549.   approximation is selected by entering dt<0.
  3550.  
  3551.   There are two options that have unusual effects on these fractals.  The
  3552.   Orbit Delay value controls how many initial points are computed before
  3553.   the orbits are displayed on the screen.  This allows the orbit to settle
  3554.   down.  The outside=summ option causes each pixel to increment color
  3555.   every time an orbit touches it; the resulting display is a 2-d
  3556.   histogram.
  3557.  
  3558.   These fractals are discussed in Chapter 14 of Pickover's "Computers,
  3559.   Pattern, Chaos, and Beauty".
  3560.  
  3561.                       Fractint Version 19.2                        Page 65
  3562.  
  3563.  2.44 Mandelcloud
  3564.  
  3565.   (type=mandelcloud)
  3566.  
  3567.   This fractal computes the Mandelbrot function, but displays it
  3568.   differently.  It starts with regularly spaced initial pixels and
  3569.   displays the resulting orbits.  This idea is somewhat similar to the
  3570.   Dynamic System (p. 64).
  3571.  
  3572.   There are two options that have unusual effects on this fractal.  The
  3573.   Orbit Delay value controls how many initial points are computed before
  3574.   the orbits are displayed on the screen.  This allows the orbit to settle
  3575.   down.  The outside=summ option causes each pixel to increment color
  3576.   every time an orbit touches it; the resulting display is a 2-d
  3577.   histogram.
  3578.  
  3579.   This fractal was invented by Noel Giffin.
  3580.  
  3581.  
  3582.  
  3583.  2.45 Quaternion
  3584.  
  3585.   (type=quat,quatjul)
  3586.  
  3587.   These fractals are based on quaternions.  Quaternions are an extension
  3588.   of complex numbers, with 4 parts instead of 2.  That is, a quaternion Q
  3589.   equals a+ib+jc+kd, where a,b,c,d are reals.  Quaternions have rules for
  3590.   addition and multiplication.  The normal Mandelbrot and Julia formulas
  3591.   can be generalized to use quaternions instead of complex numbers.
  3592.  
  3593.   There is one complication.  Complex numbers have 2 parts, so they can be
  3594.   displayed on a plane.  Quaternions have 4 parts, so they require 4
  3595.   dimensions to view.  That is, the quaternion Mandelbrot set is actually
  3596.   a 4-dimensional object.  Each quaternion C generates a 4-dimensional
  3597.   Julia set.
  3598.  
  3599.   One method of displaying the 4-dimensional object is to take a 3-
  3600.   dimensional slice and render the resulting object in 3-dimensional
  3601.   perspective.  Fractint isn't that sophisticated, so it merely displays a
  3602.   2-dimensional slice of the resulting object. (Note: Now Fractint is that
  3603.   sophisticated!  See the Julibrot type!)
  3604.  
  3605.   In fractint, for the Julia set, you can specify the four parameters of
  3606.   the quaternion constant: c=(c1,ci,cj,ck), but the 2-dimensional slice of
  3607.   the z-plane Julia set is fixed to (xpixel,ypixel,0,0).
  3608.  
  3609.   For the Mandelbrot set, you can specify the position of the c-plane
  3610.   slice: (xpixel,ypixel,cj,ck).
  3611.  
  3612.   These fractals are discussed in Chapter 10 of Pickover's "Computers,
  3613.   Pattern, Chaos, and Beauty".
  3614.  
  3615.   See also HyperComplex (p. 66) and  Quaternion and Hypercomplex Algebra
  3616.   (p. 155)
  3617.  
  3618.                       Fractint Version 19.2                        Page 66
  3619.  
  3620.  2.46 HyperComplex
  3621.  
  3622.   (type=hypercomplex,hypercomplexj)
  3623.  
  3624.   These fractals are based on hypercomplex numbers, which like quaternions
  3625.   are a four dimensional generalization of complex numbers. It is not
  3626.   possible to fully generalize the complex numbers to four dimensions
  3627.   without sacrificing some of the algebraic properties shared by real and
  3628.   complex numbers. Quaternions violate the commutative law of
  3629.   multiplication, which says z1*z2 = z2*z1. Hypercomplex numbers fail the
  3630.   rule that says all non-zero elements have multiplicative inverses - that
  3631.   is, if z is not 0, there should be a number 1/z such that (1/z)*(z) = 1.
  3632.   This law holds most of the time but not all the time for hypercomplex
  3633.   numbers.
  3634.  
  3635.   However hypercomplex numbers have a wonderful property for fractal
  3636.   purposes.  Every function defined for complex numbers has a simple
  3637.   generalization to hypercomplex numbers. Fractint's implementation takes
  3638.   advantage of this by using "fn" variables - the iteration formula is
  3639.       h(n+1) = fn(h(n)) + C.
  3640.   where "fn" is the hypercomplex generalization of sin, cos, log, sqr etc.
  3641.   You can see 3D versions of these fractals using fractal type Julibrot.
  3642.   Hypercomplex numbers were brought to our attention by Clyde Davenport,
  3643.   author of "A Hypercomplex Calculus with Applications to Relativity",
  3644.   ISBN 0-9623837-0-8.
  3645.  
  3646.   See also Quaternion (p. 65) and  Quaternion and Hypercomplex Algebra
  3647.   (p. 155)
  3648.  
  3649.  
  3650.  
  3651.  
  3652.  2.47 Cellular Automata
  3653.  
  3654.   (type=cellular)
  3655.  
  3656.   These fractals are generated by 1-dimensional cellular automata.
  3657.   Consider a 1-dimensional line of cells, where each cell can have the
  3658.   value 0 or 1.  In each time step, the new value of a cell is computed
  3659.   from the old value of the cell and the values of its neighbors.  On the
  3660.   screen, each horizontal row shows the value of the cells at any one
  3661.   time.  The time axis proceeds down the screen, with each row computed
  3662.   from the row above.
  3663.  
  3664.   Different classes of cellular automata can be described by how many
  3665.   different states a cell can have (k), and how many neighbors on each
  3666.   side are examined (r).  Fractint implements the binary nearest neighbor
  3667.   cellular automata (k=2,r=1), the binary next-nearest neighbor cellular
  3668.   automata (k=2,r=2), and the ternary nearest neighbor cellular automata
  3669.   (k=3,r=1) and several others.
  3670.  
  3671.   The rules used here determine the next state of a given cell by using
  3672.   the sum of the states in the cell's neighborhood.  The sum of the cells
  3673.   in the neighborhood are mapped by rule to the new value of the cell.
  3674.   For the binary nearest neighbor cellular automata, only the closest
  3675.   neighbor on each side is used.  This results in a 4 digit rule
  3676.  
  3677.                       Fractint Version 19.2                        Page 67
  3678.  
  3679.   controlling the generation of each new line:  if each of the cells in
  3680.   the neighborhood is 1, the maximum sum is 1+1+1 = 3 and the sum can
  3681.   range from 0 to 3, or 4 values.  This results in a 4 digit rule.  For
  3682.   instance, in the rule 1010, starting from the right we have 0->0, 1->1,
  3683.   2->0, 3->1.  If the cell's neighborhood sums to 2, the new cell value
  3684.   would be 0.
  3685.  
  3686.   For the next-nearest cellular automata (kr = 22), each pixel is
  3687.   determined from the pixel value and the two neighbors on each side.
  3688.   This results in a 6 digit rule.
  3689.  
  3690.   For the ternary nearest neighbor cellular automata (kr = 31), each cell
  3691.   can have the value 0, 1, or 2.  A single neighbor on each side is
  3692.   examined, resulting in a 7 digit rule.
  3693.  
  3694.     kr  #'s in rule  example rule     | kr  #'s in rule  example rule
  3695.     21      4        1010             | 42     16        2300331230331001
  3696.     31      7        1211001          | 23      8        10011001
  3697.     41     10        3311100320       | 33     15        021110101210010
  3698.     51     13        2114220444030    | 24     10        0101001110
  3699.     61     16        3452355321541340 | 25     12        110101011001
  3700.     22      6        011010           | 26     14        00001100000110
  3701.     32     11        21212002010      | 27     16        0010000000000110
  3702.  
  3703.   The starting row of cells can be set to a pattern of up to 16 digits or
  3704.   to a random pattern.  The borders are set to zeros if a pattern is
  3705.   entered or are set randomly if the starting row is set randomly.
  3706.  
  3707.   A zero rule will randomly generate the rule to use.
  3708.  
  3709.   Hitting the space bar toggles between continuously generating the
  3710.   cellular automata and stopping at the end of the current screen.
  3711.  
  3712.   Recommended reading: "Computer Software in Science and Mathematics",
  3713.   Stephen Wolfram, Scientific American, September, 1984.  "Abstract
  3714.   Mathematical Art", Kenneth E. Perry, BYTE, December, 1986.  "The
  3715.   Armchair Universe", A. K. Dewdney, W. H. Freeman and Company, 1988.
  3716.   "Complex Patterns Generated by Next Nearest Neighbors Cellular
  3717.   Automata", Wentian Li, Computers & Graphics, Volume 13, Number 4.
  3718.  
  3719.  
  3720.  2.48 Ant Automaton
  3721.  
  3722.   (type=ant)
  3723.  
  3724.   This fractal type is the generalized Ant Automaton described in the
  3725.   "Computer Recreations" column of the July 1994 Scientific American. The
  3726.   article attributes this automaton to Greg Turk of Stanford University,
  3727.   Leonid A.  Bunivomitch of the Georgia Institute of Technology, and S. E.
  3728.   Troubetzkoy of the University of Bielefeld.
  3729.  
  3730.   The ant wanders around the screen, starting at the middle. A rule
  3731.   string, which the user can input as Fractint's first parameter,
  3732.   determines the ant's direction. This rule string is stored as a double
  3733.   precision number in our implementation. Only the digit 1 is significant
  3734.   -- all other digits are treated as 0. When the type 1 ant leaves a cell
  3735.  
  3736.                       Fractint Version 19.2                        Page 68
  3737.  
  3738.   (a pixel on the screen) of color k, it turns right if the kth symbol in
  3739.   the rule string is a 1, or left otherwise. Then the color in the
  3740.   abandoned cell is incremented. The type 2 ant uses only the rule string
  3741.   to move around. If the digit of the rule string is a 1, the ant turns
  3742.   right and puts a zero in current cell, otherwise it turns left and put a
  3743.   number in the current cell. An empty rule string causes the rule to be
  3744.   generated randomly.
  3745.  
  3746.   Fractint's 2nd parameter is a maximum iteration to guarantee that the
  3747.   fractal will terminate.
  3748.  
  3749.   The 3rd parameter is the number of ants (up to 256). If you select 0
  3750.   ants, then the number oif ants is random.
  3751.  
  3752.   The 4th paramter allows you to select ant type 1 (the original), or type
  3753.   2.
  3754.  
  3755.   The 5th parameter determines whether the ant's progress stops when the
  3756.   edge of the screen is reaches (as in the original implementation), or
  3757.   whether the ant's path wraps to the opposite side of the screen. You can
  3758.   slow down the ant to see her better using the <x> screen Orbit Delay -
  3759.   try 10.
  3760.  
  3761.   The 6th parameter accepts a random seed, allowing you to duplicate
  3762.   images using random values (empty rule string or 0 maximum ants.
  3763.  
  3764.   Try rule string 10. In this case, the ant moves in a seemingly random
  3765.   pattern, then suddenly marches off in a straight line. This happens for
  3766.   many other rule strings. The default 1100 produces symmetrical images.
  3767.  
  3768.   If the screen initially contains an image, the path of the ant changes.
  3769.   To try this, generate a fractal, and press <Ctrl-a>. Note that images
  3770.   seeded with an image are not (yet) reproducible in PAR files. When
  3771.   started using the <Ctrl-a> keys, after the ant is finished the default
  3772.   fractal type reverts to that of the underlying fractal.
  3773.  
  3774.   Special keystrokes are in effect during the ant's march. The <space> key
  3775.   toggles a step-by-step mode. When in this mode, press <enter> to see
  3776.   each step of the ant's progress. When orbit delay (on <x> screen) is set
  3777.   to 1, the step mode is the default.
  3778.  
  3779.   If you press the right or left arrow during the ant's journey, you can
  3780.   adjust the orbit delay factor with the arrow keys (increment by 10) or
  3781.   ctrl-arrow keys (increment by 100). Press any other key to get out of
  3782.   the orbit delay adjustment mode. Higher values cause slower motion.
  3783.   Changed values are not saved after the ant is finished, but you can set
  3784.   the orbit delay value in advance from the <x> screen.
  3785.  
  3786.  
  3787.  2.49 Phoenix
  3788.  
  3789.   (type=phoenix, mandphoenix, phoenixcplx, mandphoenixclx)
  3790.  
  3791.   The phoenix type defaults to the original phoenix curve discovered by
  3792.   Shigehiro Ushiki, "Phoenix", IEEE Transactions on Circuits and Systems,
  3793.   Vol. 35, No. 7, July 1988, pp. 788-789.  These images do not have the X
  3794.  
  3795.                       Fractint Version 19.2                        Page 69
  3796.  
  3797.   and Y axis swapped as is normal for this type.
  3798.  
  3799.   The mandphoenix type is the corresponding Mandelbrot set image of the
  3800.   phoenix type.  The spacebar toggles between the two as long as the
  3801.   mandphoenix type has an initial z(0) of (0,0).  The mandphoenix is not
  3802.   an effective index to the phoenix type, so explore the wild blue yonder.
  3803.  
  3804.   To reproduce the Mandelbrot set image of the phoenix type as shown in
  3805.   Stevens' book, "Fractal Programming in C", set initorbit=0/0 on the
  3806.   command line or with the <g> key.  The colors need to be rotated one
  3807.   position because Stevens uses the values from the previous calculation
  3808.   instead of the current calculation to determine when to bailout.
  3809.  
  3810.   The phoenixcplx type is implemented using complex constants instead of
  3811.   the real constants that Stevens used.  This recreates the mapping as
  3812.   originally presented by Ushiki.
  3813.  
  3814.   The mandphoenixclx type is the corresponding Mandelbrot set image of the
  3815.   phoenixcplx type.  The spacebar toggles between the two as long as the
  3816.   mandphoenixclx type has a perturbation of z(0) = (0,0).  The
  3817.   mandphoenixclx is an effective index to the phoenixcplx type.
  3818.  
  3819.  
  3820.  2.50 Frothy Basins
  3821.  
  3822.   (type=frothybasin)
  3823.  
  3824.   Frothy Basins, or Riddled Basins, were discovered by James C. Alexander
  3825.   of the University of Maryland.  The discussion below is derived from a
  3826.   two page article entitled "Basins of Froth" in Science News, November
  3827.   14, 1992 and from correspondence with others, including Dr. Alexander.
  3828.  
  3829.   The equations that generate this fractal are not very different from
  3830.   those that generate many other orbit fractals.
  3831.  
  3832.         Z(0) = pixel;
  3833.         Z(n+1) = Z(n)^2 - C*conj(Z(n))
  3834.         where C = 1 + A*i
  3835.  
  3836.   One of the things that makes this fractal so interesting is the shape of
  3837.   the dynamical system's attractors.  It is not at all uncommon for a
  3838.   dynamical system to have non-point attractors.  Shapes such as circles
  3839.   are very common.  Strange attractors are attractors which are themselves
  3840.   fractal.  What is unusual about this system, however, is that the
  3841.   attractors intersect.  This is the first case in which such a phenomenon
  3842.   has been observed.  The attractors for this system are made up of line
  3843.   segments which overlap to form an equilateral triangle.  This attractor
  3844.   triangle can be seen by using the "show orbits" option (the 'o' key) or
  3845.   the "orbits window" option (the ctrl-'o' key).
  3846.  
  3847.   The number of attractors present is dependant on the value of A, the
  3848.   imaginary part of C.  For values where A <= 1.028713768218725..., there
  3849.   are three attractors.  When A is larger than this critical value, two of
  3850.   attractors merge into one, leaving only two attractors.  An interesting
  3851.   variation on this fractal can be generated by applying the above mapping
  3852.   twice per each iteration.  The result is that some of the attractors are
  3853.  
  3854.                       Fractint Version 19.2                        Page 70
  3855.  
  3856.   split into two parts, giving the system either six or three attractors,
  3857.   depending on whether A is less than or greater than the critical value.
  3858.  
  3859.   These are also called "Riddled Basins" because each basin is riddled
  3860.   with holes.  Which attractor a point is eventually pulled into is
  3861.   extremely sensitive to its initial position.  A very slight change in
  3862.   any direction may cause it to end up on a different attractor.  As a
  3863.   result, the basins are thoroughly intermingled. The effect appears to be
  3864.   a frothy mixture that has been subjected to lots of stirring and
  3865.   folding.
  3866.  
  3867.   Pixel color is determined by which attractor captures the orbit.  The
  3868.   shade of color is determined by the number of iterations required to
  3869.   capture the orbit.  In Fractint, the actual shade of color used depends
  3870.   on how many colors are available in the video mode being used.  If 256
  3871.   colors are available, the default coloring scheme is determined by the
  3872.   number of iterations that were required to capture the orbit.  An
  3873.   alternative coloring scheme can be used where the shade is determined by
  3874.   the iterations required divided by the maximum iterations.  This method
  3875.   is especially useful on deeply zoomed images.  If only 16 colors are
  3876.   available, then only the alternative coloring scheme is used.  If fewer
  3877.   than 16 colors are available, then Fractint just colors the basins
  3878.   without any shading.
  3879.  
  3880.                       Fractint Version 19.2                        Page 71
  3881.  
  3882.  3. Doodads, Bells, and Whistles
  3883.  
  3884.  
  3885.  3.1 Drawing Method
  3886.  
  3887.   The "passes option" (<X> options screen or "passes=" parameter) selects
  3888.   one of the single-pass, dual-pass, triple-pass, solid-guessing
  3889.   (default), boundary tracing, or tesseral modes.  This option applies to
  3890.   most fractal types.
  3891.  
  3892.   Single-pass mode ("1") draws the screen pixel by pixel.
  3893.  
  3894.   Dual-pass ("2") generates a half-resolution screen first as a preview
  3895.   using 2x2-pixel boxes, and then generates the rest of the dots with a
  3896.   second pass. Dual-pass uses no more time than single-pass.
  3897.  
  3898.   Triple-pass ("3") generates the coarse first pass of the solidguessing
  3899.   mode (see "g" below), then switches to either "1" (with low resolution
  3900.   video modes) or "2" (with higher resolution video modes). The advantage
  3901.   of '3' vs '2' is that when using high resolution modes, the first pass
  3902.   has a much lower resolution (about 160x120) and is therefore much
  3903.   quicker than the first pass of the passes=2 mode. However, with the '2'
  3904.   mode, the first pass does not represent wasted time. The '3' mode wastes
  3905.   the effort of generating the coarse first screen.
  3906.  
  3907.   The single, dual, and triple pass modes all result in identical images.
  3908.   These modes are for those who desire the highest possible accuracy. Most
  3909.   people will want to use the guessing mode, described next.
  3910.  
  3911.   Solid-guessing ("g") is the default.  It performs from two to four
  3912.   visible passes - more in higher resolution video modes. Its first
  3913.   visible pass is actually two passes - one pixel per 4x4, 8x8, or 16x16
  3914.   pixel box is generated, and the guessing logic is applied to fill in the
  3915.   blocks at the next level (2x2, 4x4, or 8x8).  Subsequent passes fill in
  3916.   the display at the next finer resolution, skipping blocks which are
  3917.   surrounded by the same color. Solid-guessing can guess wrong, but it
  3918.   sure guesses quickly!
  3919.  
  3920.   Boundary Tracing ("b"), which only works accurately with fractal types
  3921.   (such as the Mandelbrot set, but not the Newton type) that do not
  3922.   contain "islands" of colors, finds a color boundary, traces it around
  3923.   the screen, and then "blits" in the color over the enclosed area.
  3924.  
  3925.   Tesseral ("t") is a sort of "super-solid-guessing" option that
  3926.   successively divides the image into subsections and colors in rectangles
  3927.   that have a boundary of a solid color. It's actually slower than the
  3928.   solid-guessing algorithm, but it looks neat, so we left it in. This mode
  3929.   is also subject to errors when islands of color appear inside the
  3930.   rectangles.
  3931.  
  3932.   The "fillcolor=" option in the <X> screen or on the command line sets a
  3933.   fixed color to be used by the Boundary Tracing and Tesseral calculations
  3934.   for filling in defined regions. The effect of this is to show off the
  3935.   boundaries of the areas delimited by these two methods.
  3936.  
  3937.                       Fractint Version 19.2                        Page 72
  3938.  
  3939.  3.2 Palette Maps
  3940.  
  3941.   If you have a VGA, MCGA, Super-VGA, 8514/A, XGA, TARGA, or TARGA+ video
  3942.   adapter, you can save and restore color palettes for use with any image.
  3943.   To load a palette onto an existing image, use the <L> command in color-
  3944.   cycling or palette-editing mode.  To save a palette, use the <S> command
  3945.   in those modes.  To change the default palette for an entire run, use
  3946.   the command line "map=" parameter.
  3947.  
  3948.   The default filetype for color-map files is ".MAP".
  3949.  
  3950.   These color-maps are ASCII text files set up as a series of RGB triplet
  3951.   values (one triplet per line, encoded as the red, green, and blue [RGB]
  3952.   components of the color).
  3953.  
  3954.   Note that .MAP file color values are in GIF format - values go from 0
  3955.   (low) to 255 (high), so for a VGA adapter they get divided by 4 before
  3956.   being stuffed into the VGA's Video-DAC registers (so '6' and '7' end up
  3957.   referring to the same color value).
  3958.  
  3959.   Fractint is distributed with some sample .MAP files:
  3960.      ALTERN.MAP    the famous "Peterson-Vigneau Pseudo-Grey Scale"
  3961.      BLUES.MAP     for rainy days, by Daniel Egnor
  3962.      CHROMA.MAP    general purpose, chromatic
  3963.      DEFAULT.MAP   the VGA start-up values
  3964.      FIRESTRM.MAP  general purpose, muted fire colors
  3965.      GAMMA1.MAP and GAMMA2.MAP  Lee Crocker's response to ALTERN.MAP
  3966.      GLASSES1.MAP  used with 3d glasses modes
  3967.      GLASSES2.MAP  used with 3d glasses modes
  3968.      GOODEGA.MAP   for EGA users
  3969.      GREEN.MAP     shaded green
  3970.      GREY.MAP      another grey variant
  3971.      GRID.MAP      for stereo surface grid images
  3972.      HEADACHE.MAP  major stripes, by D. Egnor (try cycling and hitting <2>)
  3973.      LANDSCAP.MAP  Guruka Singh Khalsa's favorite map for plasma "landscapes"
  3974.      NEON.MAP      a flashy map, by Daniel Egnor
  3975.      PAINTJET.MAP  high resolution mode PaintJet colors
  3976.      ROYAL.MAP     the royal purple, by Daniel Egnor
  3977.      TOPO.MAP      Monte Davis's contribution to full color terrain
  3978.      VOLCANO.MAP   an explosion of lava, by Daniel Egnor
  3979.  
  3980.  
  3981.  3.3 Autokey Mode
  3982.  
  3983.   The autokey feature allows you to set up beautiful self-running demo
  3984.   "loops". You can set up hypnotic sequences to attract people to a booth,
  3985.   to generate sequences for special effects, to teach how Fractal
  3986.   exploring is done, etc.
  3987.  
  3988.   A sample autokey file (DEMO.KEY) and a batch to run it (DEMO.BAT) are
  3989.   included with Fractint. Type "demo" at the DOS prompt to run it.
  3990.  
  3991.   Autokey record mode is enabled with the command line parameter
  3992.   "AUTOKEY=RECORD". Keystrokes are saved in an intelligible text format in
  3993.   a file called AUTO.KEY. You can change the file name with the
  3994.   "AUTOKEYNAME=" parameter.
  3995.  
  3996.                       Fractint Version 19.2                        Page 73
  3997.  
  3998.   Playback is enabled with the parameter "AUTOKEY=PLAY". Playback can be
  3999.   terminated by pressing the <Esc> key.
  4000.  
  4001.   After using record mode to capture an autokey file, you'll probably want
  4002.   to touch it up using your editor before playing it back.
  4003.  
  4004.   Separate lines are not necessary but you'll probably find it easier to
  4005.   understand an autokey file if you put each command on a separate line.
  4006.   Autokey files can contain the following:
  4007.  
  4008.     Quoted strings. Fractint reads whatever is between the quotes just as
  4009.     if you had typed it. For example,
  4010.         "t" "ifs" issues the "t" (type) command and then enters the
  4011.     letters i", "f", and "s" to select the ifs type.
  4012.  
  4013.     Symbols for function keys used to select a video mode. Examples:
  4014.         F3  -- Function key 3
  4015.         SF3 --<Shift> and <F3> together
  4016.  
  4017.     Special keys: ENTER ESC F1 PAGEUP PAGEDOWN HOME END LEFT RIGHT UP DOWN
  4018.     INSERT DELETE TAB
  4019.  
  4020.     WAIT <nnn.n> -- wait nnn.n seconds before continuing
  4021.  
  4022.     CALCWAIT -- pause until the current fractal calculation or file save
  4023.     or restore is finished. This command makes demo files more robust
  4024.     since calculation times depend on the  speed of the machine running
  4025.     the demo - a "WAIT 10" command may allow enough time to complete a
  4026.     fractal on one machine, but not on another. The record mode does not
  4027.     generate this command - it should be added by hand to the autokey file
  4028.     whenever there is a process that should be allowed to run to
  4029.     completion.
  4030.  
  4031.     GOTO target -- The autokey file continues to be read from the label
  4032.     "target". The label can be any word that does not duplicate a key
  4033.     word.  It must be present somewhere in the autokey file with a colon
  4034.     after it.  Example:
  4035.         MESSAGE 2 This is executed once
  4036.         start:
  4037.         MESSAGE 2 This is executed repeatedly
  4038.         GOTO start
  4039.     GOTO is mainly useful for writing continuous loop demonstrations. It
  4040.     can also be useful when debugging an autokey file, to skip sections of
  4041.     it.
  4042.  
  4043.     ; -- A semi-colon indicates that the rest of the line containing it is
  4044.     a comment.
  4045.  
  4046.     MESSAGE nn <Your message here> -- Places a message on the top of the
  4047.     screen for nn seconds
  4048.  
  4049.   Making Fractint demos can be tricky. Here are some suggestions which may
  4050.   help:
  4051.  
  4052.                       Fractint Version 19.2                        Page 74
  4053.  
  4054.     Start Fractint with "fractint autokeyname=mydemo.key autokey=record".
  4055.     Use a unique name each time you run so that you don't overwrite prior
  4056.     files.
  4057.  
  4058.     When in record mode, avoid using the cursor keys to select filenames,
  4059.     fractal types, formula names, etc. Instead, try to type in names. This
  4060.     will ensure that the exact item you want gets chosen during playback
  4061.     even if the list is different then.
  4062.  
  4063.     Beware of video mode assumptions. It is safest to build a separate
  4064.     demo for different resolution monitors.
  4065.  
  4066.     When in the record mode, try to type names quickly, then pause. If you
  4067.     pause partway through a name Fractint will break up the string in the
  4068.     .KEY file. E.g. if you paused in the middle of typing fract001, you
  4069.     might get:
  4070.         "fract"
  4071.         WAIT 2.2
  4072.         "001"
  4073.     No harm done, but messy to clean up. Fractint ignores pauses less than
  4074.     about 1/2 second.
  4075.  
  4076.     DO pause when you want the viewer to see what is happening during
  4077.     playback.
  4078.  
  4079.     When done recording, clean up your mydemo.key file. Insert a CALCWAIT
  4080.     after each keystroke which triggers something that takes a variable
  4081.     amount of time (calculating a fractal, restoring a file, saving a
  4082.     file).
  4083.  
  4084.     Add comments with ";" to the file so you know what is going on in
  4085.     future.
  4086.  
  4087.     It is a good idea to use INSERT before a GOTO which restarts the demo.
  4088.     The <insert> key resets Fractint as if you exited the program and
  4089.     restarted it.
  4090.  
  4091.   Warning: an autokey file built for this version of Fractint will
  4092.   probably require some retouching before it works with future releases of
  4093.   Fractint.  We have no intention of making sure that the same sequence of
  4094.   keystrokes will have exactly the same effect from one version of
  4095.   Fractint to the next. That would require pretty much freezing Fractint
  4096.   development, and we just love to keep enhancing it!
  4097.  
  4098.  
  4099.  3.4 Distance Estimator Method
  4100.  
  4101.   This is Phil Wilson's implementation of an alternate method for the M
  4102.   and J sets, based on work by mathematician John Milnor and described in
  4103.   "The Science of Fractal Images", p. 198.  While it can take full
  4104.   advantage of your color palette, one of the best uses is in preparing
  4105.   monochrome images for a printer.  Using the 1600x1200x2 disk-video mode
  4106.   and an HP LaserJet, we have produced pictures of quality equivalent to
  4107.   the black and white illustrations of the M-set in "The Beauty of
  4108.   Fractals."
  4109.  
  4110.                       Fractint Version 19.2                        Page 75
  4111.  
  4112.   The distance estimator method widens very thin "strands" which are part
  4113.   of the "inside" of the set.  Instead of hiding invisibly between pixels,
  4114.   these strands are made one pixel wide.
  4115.  
  4116.   Though this option is available with any escape time fractal type, the
  4117.   formula used is specific to the mandel and julia types - for most other
  4118.   types it doesn't do a great job.
  4119.  
  4120.   To turn on the distance estimator method with any escape time  fractal
  4121.   type, set the "Distance Estimator" value on the <Y> options screen (or
  4122.   use the "distest=" command line parameter).
  4123.  
  4124.   Setting the distance estimator option to a negative value -nnn enables
  4125.   edge-tracing mode.  The edge of the set is display as color number nnn.
  4126.   This option works best when the "inside" and "outside" color values are
  4127.   also set to some other value(s).
  4128.  
  4129.   In a 2 color (monochrome) mode, setting to any positive value results in
  4130.   the inside of the set being expanded to include edge points, and the
  4131.   outside points being displayed in the other color.
  4132.  
  4133.   In color modes, setting to value 1 causes the edge points to be
  4134.   displayed using the inside color and the outside points to be displayed
  4135.   in their usual colors.  Setting to a value greater than one causes the
  4136.   outside points to be displayed as contours, colored according to their
  4137.   distance from the inside of the set.  Use a higher value for narrower
  4138.   color bands, a lower value for wider ones.  1000 is a good value to
  4139.   start with.
  4140.  
  4141.   The second distance estimator parameter ("width factor") sets the
  4142.   distance from the inside of the set which is to be considered as part of
  4143.   the inside.  This value is expressed as a percentage of a pixel width,
  4144.   the default is 71.  Negative values are now allowed and give a fraction
  4145.   of a percent of the pixel width.  For example: -71 gives 1/71 % of the
  4146.   pixel width.
  4147.  
  4148.   You should use 1 or 2 pass mode with the distance estimator method, to
  4149.   avoid missing some of the thin strands made visible by it.  For the
  4150.   highest quality, "maxiter" should also be set to a high value, say 1000
  4151.   or so.  You'll probably also want "inside" set to zero, to get a black
  4152.   interior.
  4153.  
  4154.   Enabling the distance estimator method automatically toggles to floating
  4155.   point mode. When you reset distest back to zero, remember to also turn
  4156.   off floating point mode if you want it off.
  4157.  
  4158.   Unfortunately, images using the distance estimator method can take many
  4159.   hours to calculate even on a fast machine with a coprocessor, especially
  4160.   if a high "maxiter" value is used.  One way of dealing with this is to
  4161.   leave it turned off while you find and frame an image.  Then hit <B> to
  4162.   save the current image information in a parameter file (see Parameter
  4163.   Save/Restore Commands (p. 23)).  Use an editor to change the parameter
  4164.   file entry, adding "distest=1", "video=something" to select a high-
  4165.   resolution monochrome disk-video mode, "maxiter=1000", and "inside=0".
  4166.   Run the parameter file entry with the <@> command when you won't be
  4167.   needing your machine for a while (over the weekend?)
  4168.  
  4169.                       Fractint Version 19.2                        Page 76
  4170.  
  4171.  3.5 Inversion
  4172.  
  4173.   Many years ago there was a brief craze for "anamorphic art": images
  4174.   painted and viewed with the use of a cylindrical mirror, so that  they
  4175.   looked weirdly distorted on the canvas but correct in the distorted
  4176.   reflection. (This byway of art history may be a useful defense when your
  4177.   friends and family give you odd looks for staring at fractal images
  4178.   color-cycling on a CRT.)
  4179.  
  4180.   The Inversion option performs a related transformation on most of the
  4181.   fractal types. You define the center point and radius of a circle;
  4182.   Fractint maps each point inside the circle to a corresponding point
  4183.   outside, and vice-versa. This is known to mathematicians as inverting
  4184.   (or if you want to get precise, "everting") the plane, and is something
  4185.   they can contemplate without getting a headache. John Milnor (also
  4186.   mentioned in connection with the Distance Estimator Method (p. 74)),
  4187.   made his name in the 1950s with a method for everting a seven-
  4188.   dimensional sphere, so we have a lot of catching up to do.
  4189.  
  4190.   For example, if a point inside the circle is 1/3 of the way from the
  4191.   center to the radius, it is mapped to a point along the same radial
  4192.   line, but at a distance of (3 * radius) from the origin. An outside
  4193.   point at 4 times the radius is mapped inside at 1/4 the radius.
  4194.  
  4195.   The inversion parameters on the <Y> options screen allow entry of the
  4196.   radius and center coordinates of the inversion circle. A default choice
  4197.   of -1 sets the radius at 1/6 the smaller dimension of the image
  4198.   currently on the screen.  The default values for Xcenter and Ycenter use
  4199.   the coordinates currently mapped to the center of the screen.
  4200.  
  4201.   Try this one out with a Newton (p. 38) plot, so its radial "spokes"
  4202.   will give you something to hang on to. Plot a Newton-method image, then
  4203.   set the inversion radius to 1, with default center coordinates. The
  4204.   center "explodes" to the periphery.
  4205.  
  4206.   Inverting through a circle not centered on the origin produces bizarre
  4207.   effects that we're not even going to try to describe. Aren't computers
  4208.   wonderful?
  4209.  
  4210.  
  4211.  3.6 Decomposition
  4212.  
  4213.   You'll remember that most fractal types are calculated by iterating a
  4214.   simple function of a complex number, producing another complex number,
  4215.   until either the number exceeds some pre-defined "bailout" value, or the
  4216.   iteration limit is reached. The pixel corresponding to the starting
  4217.   point is then colored based on the result of that calculation.
  4218.  
  4219.   The decomposition option ("decomp=", on the <X> screen) toggles to
  4220.   another coloring protocol.  Here the points are colored according to
  4221.   which quadrant of the complex plane (negative real/positive imaginary,
  4222.   positive real/positive imaginary, etc.) the final value is in. If you
  4223.   use 4 as the parameter, points ending up in each quadrant are given
  4224.   their own color; if 2 (binary decomposition), points in alternating
  4225.   quadrants are given 2 alternating colors.
  4226.  
  4227.                       Fractint Version 19.2                        Page 77
  4228.  
  4229.   The result is a kind of warped checkerboard coloring, even in areas that
  4230.   would ordinarily be part of a single contour. Remember, for the M-set
  4231.   all points whose final values exceed 2 (by any amount) after, say, 80
  4232.   iterations are normally the same color; under decomposition, Fractint
  4233.   runs [bailout-value] iterations and then colors according to where the
  4234.   actual final value falls on the complex plane.
  4235.  
  4236.   When using decomposition, a higher bailout value will give a more
  4237.   accurate plot, at some expense in speed.  You might want to set the
  4238.   bailout value (in the parameters prompt following selection of a new
  4239.   fractal type; present for most but not all types) to a higher value than
  4240.   the default.  A value of about 50 is a good compromise for M/J sets.
  4241.  
  4242.  
  4243.  3.7 Logarithmic Palettes and Color Ranges
  4244.  
  4245.   By default, Fractint maps iterations to colors 1:1. I.e. if the
  4246.   calculation for a fractal "escapes" (exceeds the bailout value) after N
  4247.   iterations, the pixel is colored as color number N. If N is greater than
  4248.   the number of colors available, it wraps around. So, if you are using a
  4249.   16-color video mode, and you are using the default maximum iteration
  4250.   count of 150, your image will run through the 16-color palette 150/16 =
  4251.   9.375 times.
  4252.  
  4253.   When you use Logarithmic palettes, the entire range of iteration values
  4254.   is compressed to map to one span of the color range.  This results in
  4255.   spectacularly different images if you are using a high iteration limit
  4256.   near the current iteration maximum of 32000 and are zooming in on an
  4257.   area near a "lakelet".
  4258.  
  4259.   When using a compressed palette in a 256 color mode, we suggest changing
  4260.   your colors from the usual defaults.  The last few colors in the default
  4261.   IBM VGA color map are black.  This results in points nearest the "lake"
  4262.   smearing into a single dark band, with little contrast from the blue (by
  4263.   default) lake.
  4264.  
  4265.   Fractint has a number of types of compressed palette, selected by the
  4266.   "Log Palette" line on the <X> screen, or by the "logmap=" command line
  4267.   parameter:
  4268.  
  4269.     logmap=1: for standard logarithmic palette.
  4270.  
  4271.     logmap=-1: "old" logarithmic palette. This variant was the only one
  4272.     used before Fractint 14.0. It differs from logmap=1 in that some
  4273.     colors are not used - logmap=1 "spreads" low color numbers which are
  4274.     unused by logmap=-1's pure logarithmic mapping so that all colors are
  4275.     assigned.
  4276.  
  4277.     logmap=N (>1): Same as logmap=1, but starting from iteration count N.
  4278.     Pixels with iteration counts less than N are mapped to color 1. This
  4279.     is useful when zooming in an area near the lake where no points in the
  4280.     image have low iteration counts - it makes use of the low colors which
  4281.     would otherwise be unused.
  4282.  
  4283.                       Fractint Version 19.2                        Page 78
  4284.  
  4285.     logmap=-N (<-1): Similar to logmap=N, but uses a square root
  4286.     distribution of the colors instead of a logarithmic one.
  4287.  
  4288.     logmap=2 or -2: Auto calculates the logmap value for maximum effect.
  4289.  
  4290.   Another way to change the 1:1 mapping of iteration counts to colors is
  4291.   to use the "RANGES=" parameter.  It has the format:
  4292.      RANGES=aa/bb/cc/dd/...
  4293.  
  4294.   Iteration counts up to and including the first value are mapped to color
  4295.   number 0, up to and including the second value to color number 1, and so
  4296.   on. The values must be in ascending order.
  4297.  
  4298.   A negative value can be specified for "striping". The negative value
  4299.   specifies a stripe width, the value following it specifies the limit of
  4300.   the striped range.  Two alternating colors are used within the striped
  4301.   range.
  4302.  
  4303.   Example:
  4304.      RANGES=0/10/30/-5/65/79/32000
  4305.   This example maps iteration counts to colors as follows:
  4306.  
  4307.       color    iterations
  4308.       -------------------
  4309.         0      unused (formula always iterates at least once)
  4310.         1       1 to 10
  4311.         2      11 to 30
  4312.         3      31 to 35, 41 to 45, 51 to 55, and 61 to 65
  4313.         4      36 to 40, 46 to 50, and 56 to 60
  4314.         5      66 to 79
  4315.         6      80 and greater
  4316.   Note that the maximum value in a RANGES parameter is 32767.
  4317.  
  4318.  
  4319.  3.8 Biomorphs
  4320.  
  4321.   Related to Decomposition (p. 76) are the "biomorphs" invented by
  4322.   Clifford Pickover, and discussed by A. K. Dewdney in the July 1989
  4323.   "Scientific American", page 110.  These are so-named because this
  4324.   coloring scheme makes many fractals look like one-celled animals.  The
  4325.   idea is simple.  The escape-time algorithm terminates an iterating
  4326.   formula when the size of the orbit value exceeds a predetermined bailout
  4327.   value. Normally the pixel corresponding to that orbit is colored
  4328.   according to the iteration when bailout happened. To create biomorphs,
  4329.   this is modified so that if EITHER the real OR the imaginary component
  4330.   is LESS than the bailout, then the pixel is set to the "biomorph" color.
  4331.   The effect is a bit better with higher bailout values: the bailout is
  4332.   automatically set to 100 when this option is in effect. You can try
  4333.   other values with the "bailout=" option.
  4334.  
  4335.   The biomorph option is turned on via the "biomorph=nnn" command-line
  4336.   option (where "nnn" is the color to use on the affected pixels).  When
  4337.   toggling to Julia sets, the default corners are three times bigger than
  4338.   normal to allow seeing the biomorph appendages. Does not work with all
  4339.   types - in particular it fails with any of the mandelsine family.
  4340.   However, if you are stuck with monochrome graphics, try it - works great
  4341.  
  4342.                       Fractint Version 19.2                        Page 79
  4343.  
  4344.   in two-color modes. Try it with the marksmandel and marksjulia types.
  4345.  
  4346.  
  4347.  3.9 Continuous Potential
  4348.  
  4349.   Note: This option can only be used with 256 color modes.
  4350.  
  4351.   Fractint's images are usually calculated by the "level set" method,
  4352.   producing bands of color corresponding to regions where the calculation
  4353.   gives the same value. When "3D" transformed (see "3D" Images (p. 85)),
  4354.   most images other than plasma clouds are like terraced landscapes: most
  4355.   of the surface is either horizontal or vertical.
  4356.  
  4357.   To get the best results with the "illuminated" 3D fill options 5 and 6,
  4358.   there is an alternative approach that yields continuous changes in
  4359.   colors.
  4360.  
  4361.   Continuous potential is approximated by calculating
  4362.  
  4363.            potential =  log(modulus)/2^iterations
  4364.  
  4365.   where "modulus" is the orbit value (magnitude of the complex number)
  4366.   when the modulus bailout was exceeded, at the "iterations" iteration.
  4367.   Clear as mud, right?
  4368.  
  4369.   Fortunately, you don't have to understand all the details. However,
  4370.   there ARE a few points to understand. First, Fractint's criterion for
  4371.   halting a fractal calculation, the "modulus bailout value", is generally
  4372.   set to 4.  Continuous potential is inaccurate at such a low value.
  4373.  
  4374.   The bad news is that the integer math which makes the "mandel" and
  4375.   "julia" types so fast imposes a hard-wired maximum value of 127. You can
  4376.   still make interesting images from those types, though, so don't avoid
  4377.   them. You will see "ridges" in the "hillsides." Some folks like the
  4378.   effect.
  4379.  
  4380.   The good news is that the other fractal types, particularly the
  4381.   (generally slower) floating point algorithms, have no such limitation.
  4382.   The even better news is that there is a floating-point algorithm for the
  4383.   "mandel" and "julia" types.  To force the use of a floating-point
  4384.   algorithm, use Fractint with the "FLOAT=YES" command-line toggle.  Only
  4385.   a few fractal types like plasma clouds, the Barnsley IFS type, and
  4386.   "test" are unaffected by this toggle.
  4387.  
  4388.   The parameters for continuous potential are:
  4389.       potential=maxcolor[/slope[/modulus[/16bit]]]
  4390.   These parameters are present on the <Y> options screen.
  4391.  
  4392.   "Maxcolor" is the color corresponding to zero potential, which plots as
  4393.   the TOP of the mountain. Generally this should be set to one less than
  4394.   the number of colors, i.e. usually 255. Remember that the last few
  4395.   colors of the default IBM VGA palette are BLACK, so you won't see what
  4396.   you are really getting unless you change to a different palette.
  4397.  
  4398.                       Fractint Version 19.2                        Page 80
  4399.  
  4400.   "Slope" affects how rapidly the colors change -- the slope of the
  4401.   "mountains" created in 3D. If this is too low, the palette will not
  4402.   cover all the potential values and large areas will be black. If it is
  4403.   too high, the range of colors in the picture will be much less than
  4404.   those available.  There is no easy way to predict in advance what this
  4405.   value should be.
  4406.  
  4407.   "Modulus" is the bailout value used to determine when an orbit has
  4408.   "escaped". Larger values give more accurate and smoother potential. A
  4409.   value of 500 gives excellent results. As noted, this value must be <128
  4410.   for the integer fractal types (if you select a higher number, they will
  4411.   use 127).
  4412.  
  4413.   "16bit":  If you transform a continuous potential image to 3D, the
  4414.   illumination modes 5 and 6 will work fine, but the colors will look a
  4415.   bit granular. This is because even with 256 colors, the continuous
  4416.   potential is being truncated to integers. The "16bit" option can be used
  4417.   to add an extra 8 bits of goodness to each stored pixel, for a much
  4418.   smoother result when transforming to 3D.
  4419.  
  4420.   Fractint's visible behavior is unchanged when 16bit is enabled, except
  4421.   that solid guessing and boundary tracing are not used. But when you save
  4422.   an image generated with 16bit continuous potential:
  4423.    o The saved file is a fair bit larger.
  4424.    o Fractint names the file with a .POT extension instead of .GIF, if you
  4425.      didn't specify an extension in "savename".
  4426.    o The image can be used as input to a subsequent <3> command to get the
  4427.      promised smoother effect.
  4428.    o If you happen to view the saved image with a GIF viewer other than
  4429.      Fractint, you'll find that it is twice as wide as it is supposed to
  4430.      be. (Guess where the extra goodness was stored!) Though these files
  4431.      are structurally legal GIF files the double-width business made us
  4432.      think they should perhaps not be called GIF - hence the .POT filename
  4433.      extension.
  4434.  
  4435.   A 16bit (.POT) file can be converted to an ordinary 8 bit GIF by
  4436.   <R>estoring it, changing "16bit" to "no" on the <Y> options screen, and
  4437.   <S>aving.
  4438.  
  4439.   You might find with 16bit continuous potential that there's a long delay
  4440.   at the start of an image, and disk activity during calculation. Fractint
  4441.   uses its disk-video cache area to store the extra 8 bits per pixel - if
  4442.   there isn't sufficient memory available, the cache will page to disk.
  4443.  
  4444.   The following commands can be used to recreate the image that Mark
  4445.   Peterson first prototyped for us, and named "MtMand":
  4446.  
  4447.           TYPE=mandel
  4448.           CORNERS=-0.19920/-0.11/1.0/1.06707
  4449.           INSIDE=255
  4450.           MAXITER=255
  4451.           POTENTIAL=255/2000/1000/16bit
  4452.           PASSES=1
  4453.           FLOAT=yes
  4454.  
  4455.                       Fractint Version 19.2                        Page 81
  4456.  
  4457.   Note that prior to version 15.0, Fractint:
  4458.    o Produced "16 bit TGA potfiles" This format is no longer generated,
  4459.      but you can still (for a release or two) use <R> and <3> with those
  4460.      files.
  4461.    o Assumed "inside=maxit" for continuous potential. It now uses the
  4462.      current "inside=" value - to recreate prior results you must be
  4463.      explicit about this parameter.
  4464.  
  4465.  
  4466.  3.10 Starfields
  4467.  
  4468.   Once you have generated your favorite fractal image, you can convert it
  4469.   into a fractal starfield with the 'a' transformation (for 'astronomy'? -
  4470.   once again, all of the good letters were gone already).  Stars are
  4471.   generated on a pixel-by-pixel basis - the odds that a particular pixel
  4472.   will coalesce into a star are based (partially) on the color index of
  4473.   that pixel.
  4474.  
  4475.   (The following was supplied by Mark Peterson, the starfield author).
  4476.  
  4477.   If the screen were entirely black and the 'Star Density per Pixel' were
  4478.   set to 30 then a starfield transformation would create an evenly
  4479.   distributed starfield with an average of one star for every 30 pixels.
  4480.  
  4481.   If you're on a 320x200 screen then you have 64000 pixels and would end
  4482.   up with about 2100 stars.  By introducing the variable of 'Clumpiness'
  4483.   we can create more stars in areas that have higher color values.  At
  4484.   100% Clumpiness a color value of 255 will change the average of finding
  4485.   a star at that location to 50:50.  A lower clumpiness values will lower
  4486.   the amount of probability weighting.  To create a spiral galaxy draw
  4487.   your favorite spiral fractal (IFS, Julia, or Mandelbrot) and perform a
  4488.   starfield transformation.  For general starfields I'd recommend
  4489.   transforming a plasma fractal.
  4490.  
  4491.   Real starfields have many more dim stars than bright ones because very
  4492.   few stars are close enough to appear bright.  To achieve this effect the
  4493.   program will create a bell curve based on the value of ratio of Dim
  4494.   stars to bright stars.  After calculating the bell curve the curve is
  4495.   folded in half and the peak used to represent the number of dim stars.
  4496.  
  4497.   Starfields can only be shown in 256 colors.  Fractint will automatically
  4498.   try to load ALTERN.MAP and abort if the map file cannot be found.
  4499.  
  4500.  
  4501.  3.11 Bailout Test
  4502.  
  4503.   The bailout test is used to determine if we should stop iterating before
  4504.   the maximum iteration count is reached.  This test compares the value
  4505.   determined by the test to the "bailout" value set via the <Z> screen.
  4506.   The default bailout test compares the magnitude or modulus of a complex
  4507.   variable to some bailout value:
  4508.  
  4509.   bailout test = |z| = sqrt(x^2 + y^2) >= 2
  4510.  
  4511.                       Fractint Version 19.2                        Page 82
  4512.  
  4513.   As a computational speedup, we square both sides of this equation and the
  4514.   bailout test used by Fractint is:
  4515.  
  4516.   bailout test = |z|^2 = x^2 + y^2 >= 4
  4517.  
  4518.   Using a "bailout" other than 4 allows us to change when the bailout will occur.
  4519.  
  4520.   The following bailout tests have been implemented on the <Z> screen:
  4521.  
  4522.      mod:     x^2 + y^2 >= bailout
  4523.  
  4524.      real:    x^2       >= bailout
  4525.  
  4526.      imag:    y^2       >= bailout
  4527.  
  4528.      or:      x^2 >= bailout  or   y^2 >= bailout
  4529.  
  4530.      and:     x^2 >= bailout  and  y^2 >= bailout
  4531.  
  4532.   The bailout test feature has not been implemented for all applicable
  4533.   fractal types.  This is due to the speedups used for these types.  Some
  4534.   of these bailout tests show the limitations of the integer math routines
  4535.   by clipping the spiked ends off of the protrusions.
  4536.  
  4537.  
  4538.  3.12 Random Dot Stereograms (RDS)
  4539.  
  4540.   Random Dot Stereograms (RDS) are a way of encoding stereo images on a
  4541.   flat screen. Fractint can convert any image to a RDS using either the
  4542.   color number in the current palette or the grayscale value as depth. Try
  4543.   these steps. Generate a plasma fractal using the 640x480x256 video mode.
  4544.   When the image on the screen is complete, press <ctrl-s> ("s" for
  4545.   "Stereo"), and press <Enter> at the "RDS Parameters" screen prompt to
  4546.   accept the defaults. (More on the parameters in a moment.) The screen
  4547.   will be converted into a seemingly random collection of colored dots.
  4548.   Relax your eyes, looking through the screen rather than at the screen
  4549.   surface. The image will (hopefully) resolve itself into the hills and
  4550.   valleys of the 3D Plasma fractal.
  4551.  
  4552.   Because pressing the two-keyed <ctrl-s> gets tiresome after a while, we
  4553.   have made <k> key a synonym for <ctrl-s> for convenience.  Don't get too
  4554.   attached to <k> though; we reserve the right to reuse it for another
  4555.   purpose later.
  4556.  
  4557.   The RDS feature has five and sometimes six parameters. Pressing <ctrl-s>
  4558.   always takes you to the parameter screen.
  4559.  
  4560.   The first parameter allows you to control the depth effect. A larger
  4561.   value (positive or negative) exaggerates the sense of depth. If you make
  4562.   the depth negative, the high and low areas of the image are reversed. If
  4563.   your RDS image is streaky try either a lower depth factor or a higher
  4564.   resolution.
  4565.  
  4566.   The second parameter indicates the overall width in inches of the image
  4567.   on your monitor or printout. The default value of 10 inches is roughly
  4568.   the width of an image on a standard 14" to 16" monitor. This value does
  4569.  
  4570.                       Fractint Version 19.2                        Page 83
  4571.  
  4572.   not normally need to be changed for viewing images on standard monitors.
  4573.   However, if your monitor or image hardcopy is much wider or narrower
  4574.   than 10 inches (25 cm), and you have trouble seeing the image, enter the
  4575.   image width in inches. The issue here is that if the widest separation
  4576.   of left and right pixels is greater than the physical separation of your
  4577.   eyes, you will not be able to fuse the images. Conversely, a too-small
  4578.   separation may cause your eyes to hyper-converge (fuse the wrong pixels
  4579.   together). A larger width value reduces the width between left and right
  4580.   pixels. You can use the calibration feature to help set the width
  4581.   parameter - see below. Once you have found a good width setting, you can
  4582.   place the value in your SSTOOLS.INI file with the command
  4583.   monitorwidth=<nnn>.
  4584.  
  4585.   The third parameter allows you to control the method use to extract
  4586.   depth information from the original image. If your answer "no" at the
  4587.   "Use Grayscale value for Depth" prompt, then the color number of each
  4588.   pixel will be used.  This value is independent of active color palette.
  4589.   If you answer "yes" and the prompt, then the depth values are keyed to
  4590.   the brightness of the color, which will change if you change palettes.
  4591.  
  4592.   The fourth parameter allows you to set the position of vertical stereo
  4593.   calibration bars to the middle or the top of the image, or have the bars
  4594.   initially turned off. Use this feature to help you adjust your eye's
  4595.   convergence to see the image. You will see two vertical bars on the
  4596.   screen.  You can turn off and on these bars with the <Enter> or <Space>
  4597.   keys after generating the RDS image. If you save an RDS image by
  4598.   pressing <s>, if the bars are turned on at the time, they become a
  4599.   permanent part of the image.
  4600.  
  4601.   As you relax your eyes and look past the screen, these bars will appear
  4602.   as four bars. When you adjust your eyes so that the two middle bars
  4603.   merge into one bar, the 3D image should appear. The bars are set for the
  4604.   average depth in the area near the bars. They should always be closer
  4605.   together than the physical separation of your eyes, but not much less
  4606.   than about 1.5 inches.  About 1.75 inches is ideal for many images. The
  4607.   depth and screen width controls affect the width of the bars.
  4608.  
  4609.   At the RDS Parameters screen, you can select bars at the middle of the
  4610.   screen or the top. If you select "none", the bars will initially be off,
  4611.   but immediately after generation of the image you can still turn on the
  4612.   bars with <Enter> or <Space> before you press any other keys. If the
  4613.   initial setting of the calibration bars is "none", then if the bars are
  4614.   turned on later they will appear in the middle. Hint: if you cycle the
  4615.   colors and find you can't see the calibration bar, press <Enter> or
  4616.   <Space> twice, and the bars will turn to a more visible color.
  4617.  
  4618.   The fifth parameter asks if you want to use an image map GIF file
  4619.   instead of using random dots. An image map can give your RDS image a
  4620.   more interesting background texture than the random dots. If you answer
  4621.   "yes" at the Use image map? prompt, Fractint will present you with a
  4622.   file selection list of GIF images. Fractint will then go ahead and
  4623.   transform your original image to RDS using the selected image map to
  4624.   provide the "random" dots.
  4625.  
  4626.                       Fractint Version 19.2                        Page 84
  4627.  
  4628.   After you have selected an image map file, the next time you reach the
  4629.   RDS Parameters screen you will see an additional prompt asking if you
  4630.   want to use the same image map file again. Answering "yes" avoids the
  4631.   file selection menu.
  4632.  
  4633.   The best images to use as image maps are detailed textures with no solid
  4634.   spots. The default type=circle fractal works well, as do the barnsley
  4635.   fractals if you zoom in a little way. If the image map is smaller than
  4636.   your RDS image, the image map will repeated to fill the space. If the
  4637.   image map is larger, just the upper left corner of the image map will be
  4638.   used.
  4639.  
  4640.   The original image you are using for your stereogram is saved, so if you
  4641.   want to modify the stereogram parameters and try again, just press
  4642.   <ctrl-s> (or <k>) to get the parameter screen, changes the parameters,
  4643.   and press <Enter>. The original image is restored and an RDS transform
  4644.   with the revised parameters is performed. If you press <s> when viewing
  4645.   an RDS image, after the RDS image is saved, the original is restored.
  4646.  
  4647.   Try the RDS feature with continuous potential Mandelbrots as well as
  4648.   plasma fractals.
  4649.  
  4650.   For a summary of keystrokes in RDS mode, see RDS Commands (p. 30)
  4651.  
  4652.                       Fractint Version 19.2                        Page 85
  4653.  
  4654.  4. "3D" Images
  4655.  
  4656.   Fractint can restore images in "3D". Important: we use quotation marks
  4657.   because it does not CREATE images of 3D fractal objects (there are such,
  4658.   but we're not there yet.) Instead, it restores .GIF images as a 3D
  4659.   PROJECTION or STEREO IMAGE PAIR.  The iteration values you've come to
  4660.   know and love, the ones that determine pixel colors, are translated into
  4661.   "height" so that your saved screen becomes a landscape viewed in
  4662.   perspective. You can even wrap the landscape onto a sphere for
  4663.   realistic-looking planets and moons that never existed outside your PC!
  4664.  
  4665.   We suggest starting with a saved plasma-cloud screen. Hit <3> in main
  4666.   command mode to begin the process. Next, select the file to be
  4667.   transformed, and the video mode. (Usually you want the same video mode
  4668.   the file was generated in; other choices may or may not work.)
  4669.  
  4670.   After hitting <3>, you'll be bombarded with a long series of options.
  4671.   Not to worry: all of them have defaults chosen to yield an acceptable
  4672.   starting image, so the first time out just pump your way through with
  4673.   the <Enter> key. When you enter a different value for any option, that
  4674.   becomes the default value the next time you hit <3>, so you can change
  4675.   one option at a time until you get what you want. Generally <ESC> will
  4676.   take you back to the previous screen.
  4677.  
  4678.   Once you're familiar with the effects of the 3D option values you have a
  4679.   variety of options on how to specify them. You can specify them all on
  4680.   the command line (there ARE a lot of them so they may not all fit within
  4681.   the DOS command line limits), with an SSTOOLS.INI file, or with a
  4682.   parameter file.
  4683.  
  4684.   Here's an example for you power FRACTINTers, the command
  4685.  
  4686.         FRACTINT MYFILE SAVENAME=MY3D 3D=YES BATCH=YES
  4687.  
  4688.   would make Fractint load MYFILE.GIF, re-plot it as a 3D landscape
  4689.   (taking all of the defaults), save the result as MY3D.GIF, and exit to
  4690.   DOS. By the time you've come back with that cup of coffee, you'll have a
  4691.   new world to view, if not conquer.
  4692.  
  4693.   Note that the image created by 3D transformation is treated as if it
  4694.   were a plasma cloud - We have NO idea how to retain the ability to zoom
  4695.   and pan around a 3D image that has been twisted, stretched, perspective-
  4696.   ized, and water-leveled. Actually, we do, but it involves the kind of
  4697.   hardware that Industrial Light & Magic, Pixar et al. use for feature
  4698.   films. So if you'd like to send us a check equivalent to George Lucas'
  4699.   net from the "Star Wars" series...
  4700.  
  4701.  
  4702.  4.1 3D Mode Selection
  4703.  
  4704.   After hitting <3> and getting past the filename prompt and video mode
  4705.   selection, you're presented with a "3d Mode Selection" screen.  If you
  4706.   wish to change the default for any of the following parameters, use the
  4707.   cursor keys to move through the menu. When you're satisfied press
  4708.   <Enter>.
  4709.  
  4710.                       Fractint Version 19.2                        Page 86
  4711.  
  4712.   Preview Mode: Preview mode provides a rapid look at your transformed
  4713.      image using by skipping a lot of rows and filling the image in. Good
  4714.      for quickly discovering the best parameters. Let's face it, the
  4715.      Fractint authors most famous for "blazingly fast" code *DIDN'T* write
  4716.      the 3D routines!  [Pieter: "But they *are* picking away it and making
  4717.      some progress in each release."]
  4718.  
  4719.   Show Box: If you have selected Preview Mode you have another option to
  4720.      worry about. This is the option to show the image box in scaled and
  4721.      rotated coordinates x, y, and z. The box only appears in rectangular
  4722.      transformations and shows how the final image will be oriented. If
  4723.      you select light source in the next screen, it will also show you the
  4724.      light source vector so you can tell where the light is coming from in
  4725.      relation to your image. Sorry no head or tail on the vector yet.
  4726.  
  4727.   Coarseness: This sets how many divisions the image will be divided into
  4728.      in the y direction, if you select preview mode, ray tracing output,
  4729.      or grid fill in the "Select Fill Type" screen.
  4730.  
  4731.   Spherical Projection: The next question asks if you want a sphere
  4732.      projection. This will take your image and map it onto a plane if you
  4733.      answer "no" or a sphere if you answer "yes" as described above. Try
  4734.      it and you'll see what we mean.  See Spherical Projection (p. 93).
  4735.  
  4736.   Stereo:
  4737.  
  4738.      Stereo sound in Fractint? Well, not yet. Fractint now allows you to
  4739.      create 3D images for use with red/blue glasses like 3D comics you may
  4740.      have seen, or images like Captain EO.
  4741.  
  4742.      Option 0 is normal old 3D you can look at with just your eyes.
  4743.  
  4744.      Options 1 and 2 require the special red/blue-green glasses.  They are
  4745.      meant to be viewed right on the screen or on a color print off of the
  4746.      screen. The image can be made to hover entirely or partially in front
  4747.      of the screen. Great fun!  These two options give a gray scale image
  4748.      when viewed.
  4749.  
  4750.      Option 1 gives 64 shades of gray but with half the spatial resolution
  4751.      you have selected. It works by writing the red and blue images on
  4752.      adjacent pixels, which is why it eats half your resolution. In
  4753.      general, we recommend you use this only with resolutions above
  4754.      640x350. Use this mode for continuous potential landscapes where you
  4755.      *NEED* all those shades.
  4756.  
  4757.      Option "2" gives you full spatial resolution but with only 16 shades
  4758.      of gray. If the red and blue images overlap, the colors are mixed.
  4759.      Good for wire-frame images (we call them surface grids), lorenz3d and
  4760.      3D IFS. Works fine in 16 color modes.
  4761.  
  4762.      Option 3 is for creating stereo pair images for view later with more
  4763.      specialized equipment. It allows full color images to be presented in
  4764.      glorious stereo. The left image presented on the screen first. You
  4765.      may photograph it or save it. Then the second image is presented, you
  4766.      may do the same as the first image. You can then take the two images
  4767.      and convert them to a stereo image pair as outlined by Bruce Goren
  4768.  
  4769.                       Fractint Version 19.2                        Page 87
  4770.  
  4771.      (see below).
  4772.  
  4773.      Also see Stereo 3D Viewing (p. 89).
  4774.  
  4775.   Ray Tracing Output:
  4776.  
  4777.      Fractint can create files of its 3d transformations which are
  4778.      compatible with many ray tracing programs. Currently four are
  4779.      supported directly: DKB (now obsolete), VIVID, MTV, and RAYSHADE. In
  4780.      addition a "RAW" output is supported which can be relatively easily
  4781.      transformed to be usable by many other products.  One other option is
  4782.      supported: ACROSPIN.  This is not a ray tracer, but the same Fractint
  4783.      options apply - see Acrospin (p. 171).
  4784.  
  4785.      Option values:
  4786.         0  disables the creation of ray tracing output
  4787.         1  DKB format (obsolete-see below)
  4788.         2  VIVID format
  4789.         3  generic format (must be massaged externally)
  4790.         4  MTV format
  4791.         5  RAYSHADE format
  4792.         6  ACROSPIN format
  4793.      Users of POV-Ray can use the DKB output and convert to POV-Ray with
  4794.      the DKB2POV utility that comes with POV-Ray. A better (faster)
  4795.      approach is to create a RAW output file and convert to POV-Ray with
  4796.      RAW2POV.  A still better approach is to use POV-Ray's height field
  4797.      feature to directly read the fractal .GIF or .POT file and do the 3D
  4798.      transformation inside POV-Ray.
  4799.  
  4800.      All ray tracing files consist of triangles which follow the surface
  4801.      created by Fractint during the 3d transform. Triangles which lie
  4802.      below the "water line" are not created in order to avoid causing
  4803.      unnecessary work for the poor ray tracers which are already
  4804.      overworked.  A simple plane can be substituted by the user at the
  4805.      waterline if needed.
  4806.  
  4807.      The size (and therefore the number) of triangles created is
  4808.      determined by the "coarse" parameter setting. While generating the
  4809.      ray tracing file, you will view the image from above and watch it
  4810.      partitioned into triangles.
  4811.  
  4812.      The color of each triangle is the average of the color of its
  4813.      verticies in the original image, unless BRIEF is selected.
  4814.  
  4815.      If BRIEF is selected, a default color is assigned at the begining of
  4816.      the file and is used for all triangles.
  4817.  
  4818.      Also see Interfacing with Ray Tracing Programs (p. 96).
  4819.  
  4820.   Brief output:
  4821.  
  4822.      This is a ray tracing sub-option.  When it is set to yes, Fractint
  4823.      creates a considerably smaller and somewhat faster file. In this
  4824.      mode, all triangles use the default color specified at the begining
  4825.      of the file.  This color should be edited to supply the color of your
  4826.      choice.
  4827.  
  4828.                       Fractint Version 19.2                        Page 88
  4829.  
  4830.   Targa Output:
  4831.  
  4832.      If you want any of the 3d transforms you select to be saved as a
  4833.      Targa-24 file or overlayed onto one, select yes for this option.  The
  4834.      overlay option in the final screen determines whether you will create
  4835.      a new file or overlay an existing one.
  4836.  
  4837.   MAP File name:
  4838.  
  4839.      Imediately after selecting the previous options, you will be given
  4840.      the chance to select an alternate color MAP file. The default is to
  4841.      use the current MAP. If you want another MAP used, then enter your
  4842.      selection at this point.
  4843.  
  4844.   Output File Name:
  4845.  
  4846.      This is a ray tracing sub-option, used to specify the name of the
  4847.      file to be written.  The default name is FRACT001.RAY.  The name is
  4848.      incremented by one each time a file is written.  If you have not set
  4849.      "overwrite=yes" then the file name will also be automatically
  4850.      incremented to avoid over-writing previous files.
  4851.  
  4852.   When you are satisfied with your selections press enter to go to the
  4853.   next parameter screen.
  4854.  
  4855.  
  4856.  4.2 Select Fill Type Screen
  4857.  
  4858.   This option exists because in the course of the 3D projection, portions
  4859.   of the original image may be stretched to fit the new surface. Points of
  4860.   an image that formerly were right next to each other, now may have a
  4861.   space between them. This option generally determines what to do with the
  4862.   space between the mapped dots. It is not used if you have selected a
  4863.   value for RAY other than 0.
  4864.  
  4865.   For an illustration, pick the second option "just draw the points",
  4866.   which just maps points to corresponding points. Generally this will
  4867.   leave empty space between many of the points. Therefore you can choose
  4868.   various algorithms that "fill in" the space between the points in
  4869.   various ways.
  4870.  
  4871.   Later, try the first option "make a surface grid." This option will make
  4872.   a grid of the surface which is as many divisions in the original "y"
  4873.   direction as was set in "coarse" in the first screen. It is very fast,
  4874.   and can give you a good idea what the final relationship of parts of
  4875.   your picture will look like.
  4876.  
  4877.   Later, try the second option "connect the dots (wire frame)", then
  4878.   "surface fills" - "colors interpolated" and "colors not interpolated",
  4879.   the general favorites of the authors. Solid fill, while it reveals the
  4880.   pseudo-geology under your pseudo-landscape, inevitably takes longer.
  4881.  
  4882.   Later, try the light source fill types. These two algorithms allow you
  4883.   to position the "sun" over your "landscape." Each pixel is colored
  4884.   according to the angle the surface makes with an imaginary light source.
  4885.   You will be asked to enter the three coordinates of the vector pointing
  4886.  
  4887.                       Fractint Version 19.2                        Page 89
  4888.  
  4889.   toward the light in a following parameter screen - see Light Source
  4890.   Parameters (p. 92).
  4891.  
  4892.   "Light source before transformation" uses the illumination direction
  4893.   without transforming it. The light source is fixed relative to your
  4894.   computer screen.  If you generate a sequence of images with progressive
  4895.   rotation, the effect is as if you and the light source are fixed and the
  4896.   object is rotating. Therefore as the object rotates features of the
  4897.   object move in and out of the light.  This fill option was incorrect
  4898.   prior to version 16.1, and has been changed.
  4899.  
  4900.   "Light source after transformation" applies the same transformation to
  4901.   both the light direction and the object. Since both the light direction
  4902.   and the object are transformed, if you generate a sequence of images
  4903.   with the rotation progressively changed, the effect is as if the image
  4904.   and the light source are fixed in relation to each other and you orbit
  4905.   around the image. The illumination of features on the object is
  4906.   constant, but you see the object from different angles. This fill option
  4907.   was correct in earlier Fractint versions and has not been changed.
  4908.  
  4909.   For ease of discussion we will refer to the following fill types by
  4910.   these numbers:
  4911.       1 - surface grid
  4912.       2 - (default) - no fill at all - just draw the dots
  4913.       3 - wire frame - joins points with lines
  4914.       4 - surface fill - (colors interpolated)
  4915.       5 - surface fill - (interpolation turned off)
  4916.       6 - solid fill - draws lines from the "ground" up to the point
  4917.       7 - surface fill with light model - calculated before 3D transforms
  4918.       8 - surface fill with light model - calculated after 3D transforms
  4919.  
  4920.   Types 4, 7, and 8 interpolate colors when filling, making a very smooth
  4921.   fill if the palette is continuous. This may not be desirable if the
  4922.   palette is not continuous. Type 5 is the same as type 4 with
  4923.   interpolation turned off. You might want to use fill type 5, for
  4924.   example, to project a .GIF photograph onto a sphere. With type 4, you
  4925.   might see the filled-in points, since chances are the palette is not
  4926.   continuous; type 5 fills those same points in with the colors of
  4927.   adjacent pixels. However, for most fractal images, fill type 4 works
  4928.   better.
  4929.  
  4930.   This screen is not available if you have selected a ray tracing option.
  4931.  
  4932.  
  4933.  4.3 Stereo 3D Viewing
  4934.  
  4935.   The "Funny Glasses" (stereo 3D) parameter screen is presented only if
  4936.   you select a non-zero stereo option in the prior 3D parameters.  (See 3D
  4937.   Mode Selection (p. 85).)  We suggest you definitely use defaults at
  4938.   first on this screen.
  4939.  
  4940.   When you look at an image with both eyes, each eye sees the image in
  4941.   slightly different perspective because they see it from different
  4942.   places.
  4943.  
  4944.                       Fractint Version 19.2                        Page 90
  4945.  
  4946.   The first selection you must make is ocular separation, the distance the
  4947.   between the viewers eyes. This is measured as a % of screen and is an
  4948.   important factor in setting the position of the final stereo image in
  4949.   front of or behind the CRT Screen.
  4950.  
  4951.   The second selection is convergence, also as a % of screen. This tends
  4952.   to move the image forward and back to set where it floats. More positive
  4953.   values move the image towards the viewer. The value of this parameter
  4954.   needs to be set in conjunction with the setting of ocular separation and
  4955.   the perspective distance. It directly adjusts the overall separation of
  4956.   the two stereo images. Beginning anaglyphers love to create images
  4957.   floating mystically in front of the screen, but grizzled old 3D veterans
  4958.   look upon such antics with disdain, and believe the image should be
  4959.   safely inside the monitor where it belongs!
  4960.  
  4961.   Left and Right Red and Blue image crop (% of screen also) help keep the
  4962.   visible part of the right image the same as the visible part of the left
  4963.   by cropping them. If there is too much in the field of either eye that
  4964.   the other doesn't see, the stereo effect can be ruined.
  4965.  
  4966.   Red and Blue brightness factor. The generally available red/blue-green
  4967.   glasses, made for viewing on ink on paper and not the light from a CRT,
  4968.   let in more red light in the blue-green lens than we would like. This
  4969.   leaves a ghost of the red image on the blue-green image (definitely not
  4970.   desired in stereo images). We have countered this by adjusting the
  4971.   intensity of the red and blue values on the CRT. In general you should
  4972.   not have to adjust this.
  4973.  
  4974.   The final entry is Map file name (present only if stereo=1 or stereo=2
  4975.   was selected).  If you have a special map file you want to use for
  4976.   Stereo 3D this is the place to enter its name. Generally glasses1.map is
  4977.   for type 1 (alternating pixels), and glasses2.map is for type 2
  4978.   (superimposed pixels). Grid.map is great for wire-frame images using 16
  4979.   color modes.
  4980.  
  4981.   This screen is not available if you have selected a ray tracing option.
  4982.  
  4983.  
  4984.  4.4 Rectangular Coordinate Transformation
  4985.  
  4986.   The first entries are rotation values around the X, Y, and Z axes. Think
  4987.   of your starting image as a flat map: the X value tilts the bottom of
  4988.   your monitor towards you by X degrees, the Y value pulls the left side
  4989.   of the monitor towards you, and the Z value spins it counter-clockwise.
  4990.   Note that these are NOT independent rotations: the image is rotated
  4991.   first along the X-axis, then along the Y-axis, and finally along the Z-
  4992.   axis. Those are YOUR axes, not those of your (by now hopelessly skewed)
  4993.   monitor. All rotations actually occur through the center of the original
  4994.   image. Rotation parameters are not used when a ray tracing option has
  4995.   been selected.
  4996.  
  4997.   Then there are three scaling factors in percent. Initially, leave the X
  4998.   and Y axes alone and play with Z, now the vertical axis, which
  4999.   translates into surface "roughness."  High values of Z make spiky, on-
  5000.   beyond-Alpine mountains and improbably deep valleys; low values make
  5001.   gentle, rolling terrain. Negative roughness is legal: if you're doing an
  5002.  
  5003.                       Fractint Version 19.2                        Page 91
  5004.  
  5005.   M-set image and want Mandelbrot Lake to be below the ground, instead of
  5006.   eerily floating above, try a roughness of about -30%.
  5007.  
  5008.   Next we need a water level -- really a minimum-color value that performs
  5009.   the function "if (color < waterlevel) color = waterlevel". So it plots
  5010.   all colors "below" the one you choose at the level of that color, with
  5011.   the effect of filling in "valleys" and converting them to "lakes."
  5012.  
  5013.   Now we enter a perspective distance, which you can think of as the
  5014.   "distance" from your eye to the image. A zero value (the default) means
  5015.   no perspective calculations, which allows use of a faster algorithm.
  5016.   Perspective distance is not available if you have selected a ray tracing
  5017.   option.
  5018.  
  5019.   For non-zero values, picture a box with the original X-Y plane of your
  5020.   flat fractal on the bottom, and your 3D fractal inside. A perspective
  5021.   value of 100% places your eye right at the edge of the box and yields
  5022.   fairly severe distortion, like a close view through a wide-angle lens.
  5023.   200% puts your eye as far from the front of the box as the back is
  5024.   behind.  300% puts your eye twice as far from the front of the box as
  5025.   the back is, etc. Try about 150% for reasonable results. Much larger
  5026.   values put you far away for even less distortion, while values smaller
  5027.   than 100% put you "inside" the box. Try larger values first, and work
  5028.   your way in.
  5029.  
  5030.   Next, you are prompted for two types of X and Y shifts (now back in the
  5031.   plane of your screen) that let you move the final image around if you'd
  5032.   like to re-center it. The first set, x and y shift with perspective,
  5033.   move the image and the effect changes the perspective you see. The
  5034.   second set, "x and y adjust without perspective", move the image but do
  5035.   not change perspective.  They are used just for positioning the final
  5036.   image on the screen. Shifting of any type is not available if you have
  5037.   selected a ray tracing option.
  5038.  
  5039.  
  5040.  4.5 3D Color Parameters
  5041.  
  5042.   You are asked for a range of "transparent" colors, if any. This option
  5043.   is most useful when using the 3D Overlay Mode (p. 93).  Enter the color
  5044.   range (minimum and maximum value) for which you do not want to overwrite
  5045.   whatever may already be on the screen. The default is no transparency
  5046.   (overwrite everything).
  5047.  
  5048.   Now, for the final option. This one will smooth the transition between
  5049.   colors by randomizing them and reduce the banding that occurs with some
  5050.   maps. Select the value of randomize to between 0 (for no effect) and 7
  5051.   (to randomize your colors almost beyond use). 3 is a good starting
  5052.   point.
  5053.  
  5054.   That's all for this screen. Press enter for these parameters and the
  5055.   next and final screen will appear (honestly!).
  5056.  
  5057.                       Fractint Version 19.2                        Page 92
  5058.  
  5059.  4.6 Light Source Parameters
  5060.  
  5061.   This one deals with all the aspects of light source and Targa files.
  5062.  
  5063.   You must choose the direction of the light from the light source. This
  5064.   will be scaled in the x, y, and z directions the same as the image. For
  5065.   example, 1,1,3 positions the light to come from the lower right front of
  5066.   the screen in relation to the untransformed image. It is important to
  5067.   remember that these coordinates are scaled the same as your image. Thus,
  5068.   "1,1,1" positions the light to come from a direction of equal distances
  5069.   to the right, below and in front of each pixel on the original image.
  5070.   However, if the x,y,z scale is set to 90,90,30 the result will be from
  5071.   equal distances to the right and below each pixel but from only 1/3 the
  5072.   distance in front of the screen i.e.. it will be low in the sky, say,
  5073.   afternoon or morning.
  5074.  
  5075.   Then you are asked for a smoothing factor. Unless you used Continuous
  5076.   Potential (p. 79) when generating the starting image, the illumination
  5077.   when using light source fills may appear "sparkly", like a sandy beach
  5078.   in bright sun. A smoothing factor of 2 or 3 will allow you to see the
  5079.   large-scale shapes better.
  5080.  
  5081.   Smoothing is primarily useful when doing light source fill types with
  5082.   plasma clouds. If your fractal is not a plasma cloud and has features
  5083.   with sharply defined boundaries (e.g. Mandelbrot Lake), smoothing may
  5084.   cause the colors to run. This is a feature, not a bug. (A copyrighted
  5085.   response of [your favorite commercial software company here], used by
  5086.   permission.)
  5087.  
  5088.   The ambient option sets the minimum light value a surface has if it has
  5089.   no direct lighting at all. All light values are scaled from this value
  5090.   to white. This effectively adjusts the depth of the shadows and sets the
  5091.   overall contrast of the image.
  5092.  
  5093.   If you selected the full color option, you have a few more choices.  The
  5094.   next is the haze factor. Set this to make distant objects more hazy.
  5095.   Close up objects will have little effect, distant objects will have
  5096.   most.  0 disables the function. 100 is the maximum effect, the farthest
  5097.   objects will be lost in the mist. Currently, this does not really use
  5098.   distance from the viewer, we cheat and use the y value of the original
  5099.   image. So the effect really only works if the y-rotation (set earlier)
  5100.   is between +/- 30.
  5101.  
  5102.   Next, you can choose the name under which to save your Targa file. If
  5103.   you have a RAM disk handy, you might want to create the file on it, for
  5104.   speed.  So include its  full path name in this option. If you have not
  5105.   set "overwrite=yes" then the file name will be incremented to avoid
  5106.   over-writing previous files. If you are going to overlay an existing
  5107.   Targa file, enter its name here.
  5108.  
  5109.   Next, you may select the background color for the Targa file. The
  5110.   default background on the Targa file is sky blue. Enter the Red, Green,
  5111.   and Blue component for the background color you wish.
  5112.  
  5113.                       Fractint Version 19.2                        Page 93
  5114.  
  5115.   Finally, absolutely the last option (this time we mean it): you can now
  5116.   choose to overlay an existing Targa-24, type 2, non mapped, top-to-
  5117.   bottom file, such as created by Fractint or PVRay. The Targa file
  5118.   specified above will be overlayed with new info just as a GIF is
  5119.   overlayed on screen. Note: it is not necessary to use the "O" overlay
  5120.   command to overlay Targa files.  The Targa_Overlay option must be set to
  5121.   yes, however.
  5122.  
  5123.  
  5124.   You'll probably want to adjust the final colors for monochrome fill
  5125.   types using light source via color cycling (p. 16).  Try one of the
  5126.   more continuous palettes (<F8> through <F10>), or load the GRAY palette
  5127.   with the <A>lternate-map command.
  5128.  
  5129.   Now, lie down for a while in a quiet room with a damp washcloth on your
  5130.   forehead. Feeling better? Good -- because it's time to go back almost to
  5131.   the top of the 3D options and just say yes to:
  5132.  
  5133.  
  5134.  4.7 Spherical Projection
  5135.  
  5136.   Picture a globe lying on its side, "north" pole to the right. (It's our
  5137.   planet, and we'll position it the way we like.) You will be mapping the
  5138.   X and Y axes of the starting image to latitude and longitude on the
  5139.   globe, so that what was a horizontal row of pixels follows a line of
  5140.   longitude.  The defaults exactly cover the hemisphere facing you, from
  5141.   longitude 180 degrees (top) to 0 degrees (bottom) and latitude -90
  5142.   (left) to latitude 90 (right). By changing them you can map the image to
  5143.   a piece of the hemisphere or wrap it clear around the globe.
  5144.  
  5145.   The next entry is for a radius factor that controls the over-all size of
  5146.   the globe. All the rest of the entries are the same as in the landscape
  5147.   projection. You may want less surface roughness for a plausible look,
  5148.   unless you prefer small worlds with big topography, a la "The Little
  5149.   Prince."
  5150.  
  5151.   WARNING: When the "construction" process begins at the edge of the globe
  5152.   (default) or behind it, it's plotting points that will be hidden by
  5153.   subsequent points as the process sweeps around the sphere toward you.
  5154.   Our nifty hidden-point algorithms "know" this, and the first few dozen
  5155.   lines may be invisible unless a high mountain happens to poke over the
  5156.   horizon.  If you start a spherical projection and the screen stays
  5157.   black, wait for a while (a longer while for higher resolution or fill
  5158.   type 6) to see if points start to appear. Would we lie to you? If you're
  5159.   still waiting hours later, first check that the power's still on, then
  5160.   consider a faster system.
  5161.  
  5162.  
  5163.  4.8 3D Overlay Mode
  5164.  
  5165.   While the <3> command (see "3D" Images (p. 85)) creates its image on a
  5166.   blank screen, the <#> (or <shift-3> on some keyboards) command draws a
  5167.   second image over an existing displayed image. This image can be any
  5168.   restored image from a <R> command or the result of a just executed <3>
  5169.   command. So you can do a landscape, then press <#> and choose spherical
  5170.   projection to re-plot that image or another as a moon in the sky above
  5171.  
  5172.                       Fractint Version 19.2                        Page 94
  5173.  
  5174.   the landscape. <#> can be repeated as many times as you like.
  5175.  
  5176.   It's worth noting that not all that many years ago, one of us watched
  5177.   Benoit Mandelbrot and fractal-graphics wizard Dick Voss creating just
  5178.   such a moon-over-landscape image at IBM's research center in Yorktown
  5179.   Heights, NY. The system was a large and impressive mainframe with
  5180.   floating-point facilities bigger than the average minicomputer, running
  5181.   LBLGRAPH -- what Mandelbrot calls "an independent-minded and often very
  5182.   ill-mannered heap of graphics programs that originated in work by Alex
  5183.   Hurwitz and Jack Wright of IBM Los Angeles."
  5184.  
  5185.   We'd like to salute LBLGRAPH, its successors, and their creators,
  5186.   because it was their graphic output (like "Planetrise over Labelgraph
  5187.   Hill," plate C9 in Mandelbrot's "Fractal Geometry of Nature") that
  5188.   helped turn fractal geometry from a mathematical curiosity into a
  5189.   phenomenon. We'd also like to point out that it wasn't as fast, flexible
  5190.   or pretty as Fractint on a 386/16 PC with S-VGA graphics. Now, a lot of
  5191.   the difference has to do with the incredible progress of micro-processor
  5192.   power since then, so a lot of the credit should go to Intel rather than
  5193.   to our highly tuned code. OK, twist our arms -- it IS awfully good code.
  5194.  
  5195.  
  5196.  4.9 Special Note for CGA or Hercules Users
  5197.  
  5198.   If you are one of those unfortunates with a CGA or Hercules 2-color
  5199.   monochrome graphics, it is now possible for you to make 3D projection
  5200.   images.
  5201.  
  5202.   Try the following unfortunately circuitous approach. Invoke Fractint,
  5203.   making sure you have set askvideo=yes. Use a disk-video mode to create a
  5204.   256 color fractal. You might want to edit the fractint.cfg file to make
  5205.   a disk-video mode with the same pixel dimensions as your normal video.
  5206.   Using the "3" command, enter the file name of the saved 256 color file,
  5207.   then select your 2 or 4 color mode, and answer the other 3D prompts. You
  5208.   will then see a 3D projection of the fractal. Another example of Stone
  5209.   Soup responsiveness to our fan mail!
  5210.  
  5211.  
  5212.  4.10 Making Terrains
  5213.  
  5214.   If you enjoy using Fractint for making landscapes, we have several new
  5215.   features for you to work with. When doing 3d transformations banding
  5216.   tends to occur because all pixels of a given height end up the same
  5217.   color. Now, colors can be randomized to make the transitions between
  5218.   different colors at different altitudes smoother. Use the new
  5219.   "RANDOMIZE= " variable to accomplish this. If your light source images
  5220.   all look like lunar landscapes since they are all monochrome and have
  5221.   very dark shadows, we now allow you to set the ambient light for
  5222.   adjusting the contrast of the final image. Use the "Ambient= " variable.
  5223.   In addition to being able to create scenes with light sources in
  5224.   monochrome, you can now do it in full color as well. Setting fullcolor=1
  5225.   will generate a Targa-24 file with a full color image which will be a
  5226.   combination of the original colors of the source image (or map file if
  5227.   you select map=something) and the amount of light which reflects off a
  5228.   given point on the surface. Since there can be 256 different colors in
  5229.   the original image and 256 levels of light, you can now generate an
  5230.  
  5231.                       Fractint Version 19.2                        Page 95
  5232.  
  5233.   image with *lots* of colors. To convert it to a GIF if you can't view
  5234.   Targa files directly, you can use PICLAB (see Other Programs (p. 171)),
  5235.   and the following commands:
  5236.  
  5237.       SET PALETTE 256
  5238.       SET CREZ 8
  5239.       TLOAD yourfile.tga
  5240.       MAKEPAL
  5241.       MAP
  5242.       GSAVE yourfile.gif
  5243.       EXIT
  5244.   Using the full color option allows you to also set a haze factor with
  5245.   the "haze= " variable to make more distant objects more hazy.
  5246.  
  5247.   As a default, full color files also have the background set to sky blue.
  5248.   Warning, the files which are created with the full color option are very
  5249.   large, 3 bytes per pixel. So be sure to use a disk with enough space.
  5250.   The file is created using Fractint's disk-video caching, but is always
  5251.   created on real disk (expanded or extended memory is not used.) Try the
  5252.   following settings of the new variables in sequence to get a feel for
  5253.   the effect of each one:
  5254.       ;use this with any filltype
  5255.       map=topo
  5256.       randomize=3; adjusting this smooths color transitions
  5257.  
  5258.       ;now add this using filltype 5 or 6
  5259.       ambient=20; adjusting this changes the contrast
  5260.       filltype=6
  5261.       smoothing=2; makes the light not quite as granular as the terrain
  5262.  
  5263.       ;now add the following, and this is where it gets slow
  5264.       fullcolor=1; use PICLAB to reduce resulting lightfile to a GIF
  5265.  
  5266.       ;and finally this
  5267.       haze=20; sets the amount of haze for distant objects
  5268.  
  5269.   When full color is being used, the image you see on the screen will
  5270.   represent the amount of light being reflected, not the colors in the
  5271.   final image. Don't be disturbed if the colors look weird, they are an
  5272.   artifact of the process being used. The image being created in the
  5273.   lightfile won't look like the screen.
  5274.  
  5275.   However, if you are worried, hit ESC several times and when Fractint
  5276.   gets to the end of the current line it will abort. Your partial image
  5277.   will be there as LIGHT001.TGA or with whatever file name you selected
  5278.   with the lightname option. Convert it as described above and adjust any
  5279.   parameters you are not happy with. Its a little awkward, but we haven't
  5280.   figured out a better way yet.
  5281.  
  5282.                       Fractint Version 19.2                        Page 96
  5283.  
  5284.  4.11 Making 3D Slides
  5285.  
  5286.   Bruce Goren, CIS's resident stereoscopic maven, contributed these tips
  5287.   on what to do with your 3D images (Bruce inspired and prodded us so much
  5288.   we automated much of what follows, allowing both this and actual on
  5289.   screen stereo viewing, but we included it here for reference and a brief
  5290.   tutorial.)
  5291.  
  5292.   "I use a Targa 32 video card and TOPAS graphic software, moving the
  5293.   viewport or imaginary camera left and right to create two separate views
  5294.   of the stationary object in x,y,z, space. The distance between the two
  5295.   views, known as the inter-ocular distance, toe-in or convergence angle,
  5296.   is critical. It makes the difference between good 3-D and headache-
  5297.   generating bad 3-D.
  5298.  
  5299.   "For a 3D fractal landscape, I created and photographed the left and
  5300.   right eye views as if flying by in an imaginary airplane and mounted the
  5301.   film chips for stereo viewing. To make my image, first I generated a
  5302.   plasma cloud based on a color map I calculated to resemble a geological
  5303.   survey map (available on CIS as TARGA.MAP). In the 3D reconstruction, I
  5304.   used a perspective value of 150 and shifted the camera -15 and +15 on
  5305.   the X-axis for the left and right views. All other values were left to
  5306.   the defaults.
  5307.  
  5308.   "The images are captured on a Matrix 3000 film recorder -- basically a
  5309.   box with a high-resolution (1400 lines) black and white TV and a 35mm
  5310.   camera (Konica FS-1) looking at the TV screen through a filter wheel.
  5311.   The Matrix 3000 can be calibrated for 8 different film types, but so far
  5312.   I have only used Kodak Ektachrome 64 daylight for slides and a few print
  5313.   films. I glass mount the film chips myself.
  5314.  
  5315.   "Each frame is exposed three times, once through each of the red, blue,
  5316.   and green filters to create a color image from computer video without
  5317.   the scan-lines which normally result from photographing television
  5318.   screens.  The aspect ratio of the resulting images led me to mount the
  5319.   chips using the 7-sprocket Busch-European Emde masks. The best source of
  5320.   Stereo mounting and viewing supplies I know of is an outfit called Reel
  5321.   3-D Enterprises, Inc. at P.O. Box 2368, Culver City, CA 90231, tel. 213-
  5322.   837-2368. "My platform is an IBM PC/AT crystal-swapped up to 9 MHz. The
  5323.   math co-processor runs on a separate 8-MHz accessory sub-board.  The
  5324.   system currently has 6.5 MB of RAM."
  5325.  
  5326.  
  5327.  4.12 Interfacing with Ray Tracing Programs
  5328.  
  5329.   (Also see "Ray Tracing Output", "Brief", and "Output File Name" in "3D
  5330.   Mode Selection" (p. 85).)
  5331.  
  5332.   Fractint allows you to save your 3d transforms in files which may be fed
  5333.   to a ray tracer (or to "Acrospin").  However, they are not ready to be
  5334.   traced by themselves. For one thing, no light source is included. They
  5335.   are actually meant to be included within other ray tracing files.
  5336.  
  5337.   Since the intent is to produce an object which may be included in a
  5338.   larger ray tracing scene, it is expected that all rotations, shifts, and
  5339.   final scaling will be done by the ray tracer. Thus, in creating the
  5340.  
  5341.                       Fractint Version 19.2                        Page 97
  5342.  
  5343.   images, no facilities for rotations or shifting is provided. Scaling is
  5344.   provided to achieve the correct aspect ratio.
  5345.  
  5346.   WARNING! The files created using the RAY option can be huge. Setting
  5347.   COARSE to 40 will result in over 2000 triangles. Each triangle can
  5348.   utilize from 50 to 200 bytes each to describe, so your ray tracing files
  5349.   can rapidly approach or exceed 1Meg. Make sure you have enough disk
  5350.   space before you start.
  5351.  
  5352.   Each file starts with a comment identifying the version of Fractint by
  5353.   which it was created. The file ends with a comment giving the number of
  5354.   triangles in the file.
  5355.  
  5356.   The files consist of long strips of adjacent triangles. Triangles are
  5357.   clockwise or counter clockwise depending on the target ray tracer.
  5358.   Currently, MTV and Rayshade are the only ones which use counter
  5359.   clockwise triangles. The size of the triangles is set by the COARSE
  5360.   setting in the main 3d menu. Color information about each individual
  5361.   triangle is included for all files unless in the brief mode.
  5362.  
  5363.   To keep the poor ray tracer from working too hard, if WATERLINE is set
  5364.   to a non zero value, no triangle which lies entirely at or below the
  5365.   current setting of WATERLINE is written to the ray tracing file.  These
  5366.   may be replaced by a simple plane in the syntax of the ray tracer you
  5367.   are using.
  5368.  
  5369.   Fractint's coordinate system has the origin of the x-y plane at the
  5370.   upper left hand corner of the screen, with positive x to the right and
  5371.   positive y down. The ray tracing files have the origin of the x-y plane
  5372.   moved to the center of the screen with positive x to the right and
  5373.   positive y up.  Increasing values of the color index are out of the
  5374.   screen and in the +z direction. The color index 0 will be found in the
  5375.   xy plane at z=-1.
  5376.  
  5377.   When x- y- and zscale are set to 100, the surface created by the
  5378.   triangles will fall within a box of +/- 1.0 in all 3 directions.
  5379.   Changing scale will change the size and/or aspect ratio of the enclosed
  5380.   object.
  5381.  
  5382.   We will only describe the structure of the RAW format here. If you want
  5383.   to understand any of the ray tracing file formats besides RAW, please
  5384.   see your favorite ray tracer docs.
  5385.  
  5386.   The RAW format simply consists of a series of clockwise triangles. If
  5387.   BRIEF=yes, Each line is a vertex with coordinates x, y, and z. Each
  5388.   triangle is separated by a couple of CR's from the next. If BRIEF=no,
  5389.   the first line in each triangle description if the r,g,b value of the
  5390.   triangle.
  5391.  
  5392.   Setting BRIEF=yes produces shorter files with the color of each triangle
  5393.   removed - all triangles will be the same color. These files are
  5394.   otherwise identical to normal files but will run faster than the non
  5395.   BRIEF files.  Also, with BRIEF=yes, you may be able to get files with
  5396.   more triangles to run than with BRIEF=no.
  5397.  
  5398.                       Fractint Version 19.2                        Page 98
  5399.  
  5400.   The DKB format is now obsolete. POV-Ray users should use the RAW output
  5401.   and convert to POV-Ray using the POV Group's RAW2POV utility. POV-Ray
  5402.   users can also do all 3D transformations within POV-Ray using height
  5403.   fields.
  5404.  
  5405.  
  5406.  
  5407.                       Fractint Version 19.2                        Page 99
  5408.  
  5409.  5. Command Line Parameters, Parameter Files, Batch Mode
  5410.  
  5411.   Fractint accepts command-line parameters that allow you to start it with
  5412.   a particular video mode, fractal type, starting coordinates, and just
  5413.   about every other parameter and option.
  5414.  
  5415.   These parameters can also be specified in a SSTOOLS.INI file, to set
  5416.   them every time you run Fractint.
  5417.  
  5418.   They can also be specified as named groups in a .PAR (parameter) file
  5419.   which you can then call up while running Fractint by using the <@>
  5420.   command.
  5421.  
  5422.   In all three cases (DOS command line, SSTOOLS.INI, and parameter file)
  5423.   the parameters use the same syntax, usually a series of keyword=value
  5424.   commands like SOUND=OFF.  Each parameter is described in detail in
  5425.   subsequent sections.
  5426.  
  5427.  
  5428.  5.1 Using the DOS Command Line
  5429.  
  5430.   You can specify parameters when you start Fractint from DOS by using a
  5431.   command like:
  5432.  
  5433.       FRACTINT SOUND=OFF FILENAME=MYIMAGE.GIF
  5434.  
  5435.   The individual parameters are separated by one or more spaces (an
  5436.   parameter itself may not include spaces). Upper or lower case may be
  5437.   used, and parameters can be in any order.
  5438.  
  5439.   Since DOS commands are limited to 128 characters, Fractint has a special
  5440.   command you can use when you have a lot of startup parameters (or have a
  5441.   set of parameters you use frequently):
  5442.  
  5443.       FRACTINT @MYFILE
  5444.  
  5445.   When @filename is specified on the command line, Fractint reads
  5446.   parameters from the specified file as if they were keyed on the command
  5447.   line.  You can create the file with a text editor, putting one
  5448.   "keyword=value" parameter on each line.
  5449.  
  5450.  
  5451.  5.2 Setting Defaults (SSTOOLS.INI File)
  5452.  
  5453.   Every time Fractint runs, it searches the current directory, and then
  5454.   the directories in your DOS PATH, for a file named SSTOOLS.INI.  If it
  5455.   finds this file, it begins by reading parameters from it.  This file is
  5456.   useful for setting parameters you always want, such as those defining
  5457.   your printer setup.
  5458.  
  5459.   SSTOOLS.INI is divided into sections belonging to particular programs.
  5460.   Each section begins with a label in brackets. Fractint looks for the
  5461.   label [fractint], and ignores any lines it finds in the file belonging
  5462.   to any other label. If an SSTOOLS.INI file looks like this:
  5463.  
  5464.                       Fractint Version 19.2                       Page 100
  5465.  
  5466.     [fractint]
  5467.     sound=off      ; (for home use only)
  5468.     printer=hp     ; my printer is a LaserJet
  5469.     inside=0       ; using "traditional" black
  5470.     [startrek]
  5471.     warp=9.5       ; Captain, I dinna think the engines can take it!
  5472.  
  5473.   Fractint will use only the second, third, and fourth lines of the file.
  5474.   (Why use a convention like that when Fractint is the only program you
  5475.   know of that uses an SSTOOLS.INI file?  Because there are other programs
  5476.   (such as Lee Crocker's PICLAB) that now use the same file, and there may
  5477.   one day be other, sister programs to Fractint using that file.)
  5478.  
  5479.  
  5480.  5.3 Parameter Files and the <@> Command
  5481.  
  5482.   You can change parameters on-the-fly while running Fractint by using the
  5483.   <@> or <2> command and a parameter file. Parameter files contain named
  5484.   groups of parameters, looking something like this:
  5485.  
  5486.     quickdraw {      ; a set of parameters named quickdraw
  5487.        maxiter=150
  5488.        float=no
  5489.        }
  5490.     slowdraw {       ; another set of parameters
  5491.        maxiter=2000
  5492.        float=yes
  5493.        }
  5494.  
  5495.   If you use the <@> or <2> command and select a parameter file containing
  5496.   the above example, Fractint will show two choices: quickdraw and
  5497.   slowdraw. You move the cursor to highlight one of the choices and press
  5498.   <Enter> to set the parameters specified in the file by that choice.
  5499.  
  5500.   The default parameter file name is FRACTINT.PAR. A different file can be
  5501.   selected with the "parmfile=" option, or by using <@> or <2> and then
  5502.   hitting <F6>.
  5503.  
  5504.   You can create parameter files with a text editor, or for some uses, by
  5505.   using the <B> command. Parameter files can be used in a number of ways,
  5506.   some examples:
  5507.  
  5508.     o To save the parameters for a favorite image. Fractint can do this
  5509.       for you with the <B> command.
  5510.  
  5511.     o To save favorite sets of 3D transformation parameters. Fractint can
  5512.       do this for you with the <B> command.
  5513.  
  5514.     o To set up different sets of parameters you use occasionally. For
  5515.       instance, if you have two printers, you might want to set up a group
  5516.       of parameters describing each.
  5517.  
  5518.     o To save image parameters for later use in batch mode - see Batch
  5519.       Mode (p. 120).
  5520.  
  5521.                       Fractint Version 19.2                       Page 101
  5522.  
  5523.   See "Parameter Save/Restore Commands" (p. 23) for details about the <@>
  5524.   and <B> commands.
  5525.  
  5526.  
  5527.  5.4 General Parameter Syntax
  5528.  
  5529.   Parameters must be separated by one or more spaces.
  5530.  
  5531.   Upper and lower case can be used in keywords and values.
  5532.  
  5533.   Anything on a line following a ; (semi-colon) is ignored, i.e. is a
  5534.   comment.
  5535.  
  5536.   In parameter files and SSTOOLS.INI:
  5537.     o Individual parameters can be entered on separate lines.
  5538.     o Long values can be split onto multiple lines by ending a line with a
  5539.       \ (backslash) - leading spaces on the following line are ignored,
  5540.       the information on the next line from the first non-blank character
  5541.       onward is appended to the prior line.
  5542.  
  5543.   Some terminology:
  5544.     KEYWORD=nnn              enter a number in place of "nnn"
  5545.     KEYWORD=[filename]       you supply filename
  5546.     KEYWORD=yes|no|whatever  choose one of "yes", "no", or "whatever"
  5547.     KEYWORD=1st[/2nd[/3rd]]  the slash-separated parameters "2nd" and
  5548.                              "3rd" are optional
  5549.  
  5550.  
  5551.  5.5 Startup Parameters
  5552.  
  5553.   @FILENAME
  5554.   Causes Fractint to read "filename" for parameters. When it finishes, it
  5555.   resumes reading its own command line -- i.e., "FRACTINT MAXITER=250
  5556.   @MYFILE PASSES=1" is legal. This option is only valid on the DOS command
  5557.   line, as Fractint is not clever enough to deal with multiple
  5558.   indirection.
  5559.  
  5560.   @FILENAME/GROUPNAME
  5561.   Like @FILENAME, but reads a named group of parameters from a parameter
  5562.   file.  See "Parameter Files and the <@> Command" (p. 100).
  5563.  
  5564.   TEMPDIR=[directory]
  5565.   This command allows to specify the directory where Fractint writes
  5566.   temporary files.
  5567.  
  5568.   WORKDIR=[directory]
  5569.   This command sets the directory where miscellaneous Fractint files get
  5570.   written, including MAKEBIG.BAT and debugging files.
  5571.  
  5572.   FILENAME=[name]
  5573.   Causes Fractint to read the named file, which must either have been
  5574.   saved from an earlier Fractint session or be a generic GIF file, and use
  5575.   that as the starting point, bypassing the initial information screens.
  5576.   The filetype is optional and defaults to .GIF. Non-Fractint GIF files
  5577.   are restored as fractal type "plasma".
  5578.   On the DOS command line you may omit FILENAME= and just give the file
  5579.  
  5580.                       Fractint Version 19.2                       Page 102
  5581.  
  5582.   name.
  5583.  
  5584.   CURDIR=yes
  5585.   Fractint uses directories set by various commands, possibly in the
  5586.   SSTOOLS.INI file. Uf you want to try out some files in the current
  5587.   directory, such as a modified copy of FRACTINT.FRM, you won't Fractint
  5588.   to read the copy in your official FRM directory. Setting curdir=yes at
  5589.   the command line will cause Fractint to look in the current directory
  5590.   for requested files first before looking in the default directory set by
  5591.   the other commands. Warning: <tab> screen may not reflect actual file
  5592.   opened in cases where the file was opened in the DOS current directory.
  5593.  
  5594.   BATCH=yes
  5595.   See Batch Mode (p. 120).
  5596.  
  5597.   AUTOKEY=play|record
  5598.   Specifying "play" runs Fractint in playback mode - keystrokes are read
  5599.   from the autokey file (see next parameter) and interpreted as if they're
  5600.   being entered from the keyboard.
  5601.   Specifying "record" runs in recording mode - all keystrokes are recorded
  5602.   in the autokey file.
  5603.   See also Autokey Mode (p. 72).
  5604.  
  5605.   AUTOKEYNAME=[filename]
  5606.   Specifies the file name to be used in autokey mode. The default file
  5607.   name is AUTO.KEY.
  5608.  
  5609.   FPU=387|IIT|NOIIT
  5610.   This parameter is useful if you have an unusual coprocessor chip. If you
  5611.   have a 80287 replacement chip with full 80387 functionality use
  5612.   "FPU=387" to inform Fractint to take advantage of those extra 387
  5613.   instructions.  If you have the IIT fpu, but don't have IIT's
  5614.   'f4x4int.com' TSR loaded, use "FPU=IIT" to force Fractint to use that
  5615.   chip's matrix multiplication routine automatically to speed up 3-D
  5616.   transformations (if you have an IIT fpu and have that TSR loaded,
  5617.   Fractint will auto-detect the presence of the fpu and TSR and use its
  5618.   extra capabilities automatically).  Since all IIT chips support 80387
  5619.   instructions, enabling the IIT code also enables Fractint's use of all
  5620.   387 instructions.  Setting "FPU=NOIIT" disables Fractint's IIT Auto-
  5621.   detect capability.  Warning: multi-tasking operating systems such as
  5622.   Windows and DesQView don't automatically save the IIT chip extra
  5623.   registers, so running two programs at once that both use the IIT's
  5624.   matrix multiply feature but don't use the handshaking provided by that
  5625.   'f4x4int.com' program, errors will result.
  5626.  
  5627.   MAKEDOC[=filename]
  5628.   Create Fractint documentation file (for printing or viewing with a text
  5629.   editor) and then return to DOS.  Filename defaults to FRACTINT.DOC.
  5630.   There's also a function in Fractint's online help which can be used to
  5631.   produce the documentation file - use "Printing Fractint Documentation"
  5632.   from the main help index.
  5633.  
  5634.   MAXHISTORY=<nnn>
  5635.   Fractint maintains a list of parameters of the past 10 images that you
  5636.   generated in the current Fractint session. You can revisit these images
  5637.   using the <h> and <Ctrl-h> commands. The maxhistory command allows you
  5638.  
  5639.                       Fractint Version 19.2                       Page 103
  5640.  
  5641.   to set the number of image parameter sets stored in memory. The tradeoff
  5642.   is between the convenience of storing more images and memory use. Each
  5643.   image in the circular history buffer takes up over 1200 bytes, so the
  5644.   default value of ten images uses up 12,000 bytes of memory. If your
  5645.   memory is very tight, and some memory-intensive Fractint operations are
  5646.   giving "out of memory" messages, you can reduce maxistory to 2 or even
  5647.   zero. Keep in mind that every time you color cycle or change from
  5648.   integer to float or back, another image parameter set is saved, so the
  5649.   default ten images are used up quickly.
  5650.  
  5651.  
  5652.  5.6 Calculation Mode Parameters
  5653.  
  5654.   PASSES=1|2|3|guess|btm|tesseral
  5655.   Selects single-pass, dual-pass, triple-pass, solid-Guessing mode,
  5656.   Boundary Tracing, or the Tesseral algorithm.  See Drawing Method
  5657.   (p. 71).
  5658.  
  5659.   FILLCOLOR=normal|<nnn>
  5660.   Sets a color to be used for block fill by Boundary Tracing and Tesseral
  5661.   algorithms.  See Drawing Method (p. 71).
  5662.  
  5663.   FLOAT=yes
  5664.   Most fractal types have both a fast integer math and a floating point
  5665.   version. The faster, but possibly less accurate, integer version is the
  5666.   default. If you have a new 80486 or other fast machine with a math
  5667.   coprocessor, or if you are using the continuous potential option (which
  5668.   looks best with high bailout values not possible with our integer math
  5669.   implementation), you may prefer to use floating point. Just add
  5670.   "float=yes" to the command line to do so.  Also see "Limitations of
  5671.   Integer Math (And How We Cope)" (p. 134).
  5672.  
  5673.   SYMMETRY=xxx
  5674.   Forces symmetry to None, Xaxis, Yaxis, XYaxis, Origin, or Pi symmetry.
  5675.   Useful as a speedup for symmetrical fractals. This is not a kaleidoscope
  5676.   feature for imposing symmetry where it doesn't exist. Use only when the
  5677.   fractal actual exhibits the symmetry, or else results may not be
  5678.   satisfactory.
  5679.  
  5680.  
  5681.  5.7 Fractal Type Parameters
  5682.  
  5683.   TYPE=[name]
  5684.   Selects the fractal type to calculate. The default is type "mandel".
  5685.  
  5686.   PARAMS=n/n/n/n...
  5687.   Set optional (required, for some fractal types) values used in the
  5688.   calculations. These numbers typically represent the real and imaginary
  5689.   portions of some startup value, and are described in detail as needed in
  5690.   Fractal Types (p. 33).
  5691.   (Example: FRACTINT TYPE=julia PARAMS=-0.48/0.626 would wait at the
  5692.   opening screen for you to select a video mode, but then proceed straight
  5693.   to the Julia set for the stated x (real) and y (imaginary) coordinates.)
  5694.  
  5695.                       Fractint Version 19.2                       Page 104
  5696.  
  5697.   FUNCTION=[fn1[/fn2[/fn3[/fn4]]]]
  5698.   Allows setting variable functions found in some fractal type formulae.
  5699.   Possible values are sin, cos, tan, cotan, sinh, cosh, tanh, cotanh, exp,
  5700.   log, sqr, recip (i.e. 1/z), ident (i.e. identity), cosxx (cos with a pre
  5701.   version 16 bug), asin, asinh, acos, acosh, atan, atanh, sqrt,
  5702.   abs (abs(x)+i*abs(y)), cabs (sqrt(x*x + y*y)).
  5703.  
  5704.   FORMULANAME=[formulaname]
  5705.   Specifies the default formula name for type=formula fractals.  (I.e. the
  5706.   name of a formula defined in the FORMULAFILE.) Required if you want to
  5707.   generate one of these fractal types in batch mode, as this is the only
  5708.   way to specify a formula name in that case.
  5709.  
  5710.   LNAME=[lsystemname]
  5711.   Specifies the default L-System name. (I.e. the name of an entry in the
  5712.   LFILE.) Required if you want to generate one of these fractal types in
  5713.   batch mode, as this is the only way to specify an L-System name in that
  5714.   case.
  5715.  
  5716.   IFS=[ifsname]
  5717.   Specifies the default IFS name. (I.e. the name of an entry in the
  5718.   IFSFILE.) Required if you want to generate one of these fractal types in
  5719.   batch mode, as this is the only way to specify an IFS name in that case.
  5720.  
  5721.  
  5722.  5.8 Image Calculation Parameters
  5723.  
  5724.   MAXITER=nnn
  5725.   Reset the iteration maximum (the number of iterations at which the
  5726.   program gives up and says 'OK, this point seems to be part of the set in
  5727.   question and should be colored [insidecolor]') from the default 150.
  5728.   Values range from 2 to 2,147,483,647 (super-high iteration limits like
  5729.   200000000 are useful when using logarithmic palettes).  See The
  5730.   Mandelbrot Set (p. 33) for a description of the iteration method of
  5731.   calculating fractals.
  5732.   "maxiter=" can also be used to adjust the number of orbits plotted for
  5733.   3D "attractor" fractal types such as lorenz3d and kamtorus.
  5734.  
  5735.   CORNERS=[xmin/xmax/ymin/ymax[/x3rd/y3rd]]
  5736.   Example: corners=-0.739/-0.736/0.288/0.291
  5737.   Begin with these coordinates as the range of x and y coordinates, rather
  5738.   than the default values of (for type=mandel) -2.0/2.0/-1.5/1.5. When you
  5739.   specify four values (the usual case), this defines a rectangle: x-
  5740.   coordinates are mapped to the screen, left to right, from xmin to xmax,
  5741.   y-coordinates are mapped to the screen, bottom to top, from ymin to
  5742.   ymax.  Six parameters can be used to describe any rotated or stretched
  5743.   parallelogram:  (xmin,ymax) are the coordinates used for the top-left
  5744.   corner of the screen, (xmax,ymin) for the bottom-right corner, and
  5745.   (x3rd,y3rd) for the bottom-left.  Entering just "CORNERS=" tells
  5746.   Fractint to use this form (the default mode) rather than CENTER-MAG (see
  5747.   below) when saving parameters with the <B> command.
  5748.  
  5749.   CENTER-MAG=[Xctr/Yctr/Mag[/Xmagfactor/Rotation/Skew]]
  5750.   This is an alternative way to enter corners as a center point and a
  5751.   magnification that is popular with some fractal programs and
  5752.   publications.  Entering just "CENTER-MAG=" tells Fractint to use this
  5753.  
  5754.                       Fractint Version 19.2                       Page 105
  5755.  
  5756.   form rather than CORNERS (see above) when saving parameters with the <B>
  5757.   command.  The <TAB> status display shows the "corners" in both forms.
  5758.   When you specify three values (the usual case), this defines a
  5759.   rectangle:  (Xctr, Yctr) specifies the coordinates of the center of the
  5760.   image while Mag indicates the amount of magnification to use.  Six
  5761.   parameters can be used to describe any rotated or stretched
  5762.   parallelogram:  Xmagfactor tells how many times bigger the x-
  5763.   magnification is than the y-magnification, Rotation indicates how many
  5764.   degrees the image has been turned, and Skew tells how many degrees the
  5765.   image is leaning over.  Positive angles will rotate and skew the image
  5766.   counter-clockwise.
  5767.  
  5768.   BAILOUT=nnn
  5769.   Over-rides the default bailout criterion for escape-time fractals. Can
  5770.   also be set from the parameters screen after selecting a fractal type.
  5771.   See description of bailout in The Mandelbrot Set (p. 33).
  5772.  
  5773.   BAILOUTEST=mod|real|imag|or|and
  5774.   Specifies the Bailout Test (p. 81) used to determine when the fractal
  5775.   calculation has exceeded the bailout value.  The default is mod and not
  5776.   all fractal types can utilize the additional tests.
  5777.  
  5778.   RESET
  5779.   Causes Fractint to reset all calculation related parameters to their
  5780.   default values. Non-calculation parameters such as "printer=", "sound=",
  5781.   and "savename=" are not affected. RESET should be specified at the start
  5782.   of each parameter file entry (used with the <@> command) which defines
  5783.   an image, so that the entry need not describe every possible parameter -
  5784.   when invoked, all parameters not specifically set by the entry will have
  5785.   predictable values (the defaults).
  5786.  
  5787.   INITORBIT=pixel
  5788.   INITORBIT=nnn/nnn
  5789.   Allows control over the value used to begin each Mandelbrot-type orbit.
  5790.   "initorbit=pixel" is the default for most types; this command
  5791.   initializes the orbit to the complex number corresponding to the screen
  5792.   pixel. The command "initorbit=nnn/nnn" uses the entered value as the
  5793.   initializer. See the discussion of the Mandellambda Sets (p. 39) for
  5794.   more on this topic.
  5795.  
  5796.   ORBITDELAY=<nn>
  5797.   Slows up the display of orbits using the <o> command for folks with hot
  5798.   new computers. Units are in 1/10000 seconds per orbit point.
  5799.   ORBITDELAY=10 therefore allows you to see each pixel's orbit point for
  5800.   about one millisecond. For best display of orbits, try passes=1 and a
  5801.   moderate resolution such as 320x200.  Note that the first time you press
  5802.   the 'o' key with the 'orbitdelay' function active, your computer will
  5803.   pause for a half-second or so to calibrate a high-resolution timer.
  5804.  
  5805.   SHOWORBIT=yes|no
  5806.   Causes the during-generation orbits feature toggled by the <O> command
  5807.   to start off in the "on" position each time a new fractal calculation
  5808.   starts.
  5809.  
  5810.                       Fractint Version 19.2                       Page 106
  5811.  
  5812.   PERIODICITY=no|show|nnn
  5813.   Controls periodicity checking (see Periodicity Logic (p. 134)).  "no"
  5814.   turns it off, "show" lets you see which pixels were painted as "inside"
  5815.   due to being caught by periodicity.  Specifying a number causes a more
  5816.   conservative periodicity test (each increase of 1 divides test tolerance
  5817.   by 2).  Entering a negative number lets you turn on "show" with that
  5818.   number. Type lambdafn function=exp needs periodicity turned off to be
  5819.   accurate -- there may be other cases.
  5820.  
  5821.   RSEED=nnnn
  5822.   The initial random-number "seed" for plasma clouds is taken from your
  5823.   PC's internal clock-timer. This argument forces a value (which you can
  5824.   see in the <Tab> display), and allows you to reproduce plasma clouds. A
  5825.   detailed discussion of why a TRULY random number may be impossible to
  5826.   define, let alone generate, will have to wait for "FRACTINT: The 3-MB
  5827.   Doc File."
  5828.  
  5829.   SHOWDOT=<nn>
  5830.   Colors the pixel being calculated color <nn>. Useful for very slow
  5831.   fractals for showing you the calculation status.
  5832.  
  5833.   ASPECTDRIFT=<nn>
  5834.   When zooming in or out, the aspect ratio (the width to height ratio) can
  5835.   change slightly due to rounding and the noncontinuous nature of pixels.
  5836.   If the aspect changes by a factor less than <nn>, then the aspect is set
  5837.   to it's normal value, making the center-mag Xmagfactor parameter equal
  5838.   to 1.  (see CENTER-MAG above.)  The default is 0.01.  A larger value
  5839.   adjusts more often.  A value of 0 does no adjustment at all.
  5840.  
  5841.  
  5842.  5.9 Color Parameters
  5843.  
  5844.   INSIDE=nnn|bof60|bof61|zmag|attractor|epscross|startrail|period
  5845.   Set the color of the interior: for example, "inside=0" makes the M-set
  5846.   "lake" a stylish basic black. A setting of -1 makes inside=maxiter.
  5847.  
  5848.   Four more options reveal hidden structure inside the lake.  Inside=bof60
  5849.   and inside=bof61, are named after the figures on pages 60 and 61 of
  5850.   "Beauty of Fractals".  Inside=zmag is a method of coloring based on the
  5851.   magnitude of Z after the maximum iterations have been reached.  The
  5852.   affect along the edges of the Mandelbrot is like thin-metal welded
  5853.   sculpture.  Inside=period colors pixels according to the period of their
  5854.   eventual orbit.  See Inside=bof60|bof61|zmag|period (p. 151) for a
  5855.   brilliant explanation of what these do!
  5856.  
  5857.   Inside=epscross colors pixels green or yellow according to whether their
  5858.   orbits swing close to the Y-axis or X-axis, respectively.
  5859.   Inside=starcross has a coloring scheme based on clusters of points in
  5860.   the orbits. Best with outside=<nnn>. For more information, see
  5861.   Inside=epscross|startrail (p. 151).
  5862.  
  5863.   Note that the "Look for finite attractor" option on the <Y> options
  5864.   screen will override the selected inside option if an attractor is found
  5865.   - see Finite Attractors (p. 152).
  5866.  
  5867.                       Fractint Version 19.2                       Page 107
  5868.  
  5869.   OUTSIDE=nnn|iter|real|imag|summ|mult|atan
  5870.   The classic method of coloring outside the fractal is to color according
  5871.   to how many iterations were required before Z reached the bailout value,
  5872.   usually 4. This is the method used when OUTSIDE=iter.
  5873.  
  5874.   However, when Z reaches bailout the real and imaginary components can be
  5875.   at very diferent values.  OUTSIDE=real and OUTSIDE=imag color using the
  5876.   iteration value plus the real or imaginary values.  OUTSIDE=summ uses
  5877.   the sum of all these values.  These options can give a startling 3d
  5878.   quality to otherwise flat images and can change some boring images to
  5879.   wonderful ones. OUTSIDE=mult colors by multiplying the iteration by real
  5880.   divided by imaginary. There was no mathematical reason for this, it just
  5881.   seemed like a good idea.  OUTSIDE=atan colors by determining the angle
  5882.   in degrees the last iterated value has with respect to the real axis,
  5883.   and using the absolute value.
  5884.  
  5885.   Outside=nnn sets the color of the exterior to some number of your
  5886.   choosing: for example, "OUTSIDE=1" makes all points not INSIDE the
  5887.   fractal set to color 1 (blue). Note that defining an OUTSIDE color
  5888.   forces any image to be a two-color one: either a point is INSIDE the
  5889.   set, or it's OUTSIDE it.
  5890.  
  5891.   MAP=[filename]
  5892.   Reads in a replacement color map from [filename]. This map replaces the
  5893.   default color map of your video adapter. Requires a VGA or higher
  5894.   adapter.  The difference between this argument and an alternate map read
  5895.   in via <L> in color-command mode is that this one applies to the entire
  5896.   run.  See Palette Maps (p. 72).
  5897.  
  5898.   COLORS=@filename|colorspecification
  5899.   Sets colors for the current image, like the <L> function in color
  5900.   cycling and palette editing modes. Unlike the MAP= parameter, colors set
  5901.   with COLORS= do not replace the default - when you next select a new
  5902.   fractal type, colors will revert to their defaults.
  5903.   COLORS=@filename tells Fractint to use a color map file named
  5904.   "filename".  See Palette Maps (p. 72).
  5905.   COLORS=colorspecification specifies the colors directly. The value of
  5906.   "colorspecification" is rather long (768 characters for 256 color
  5907.   modes), and its syntax is not documented here.  This form of the COLORS=
  5908.   command is not intended for manual use - it exists for use by the <B>
  5909.   command when saving the description of a nice image.
  5910.  
  5911.   CYCLERANGE=nnn/nnn
  5912.   Sets the range of color numbers to be animated during color cycling.
  5913.   The default is 1/255, i.e. just color number 0 (usually black) is not
  5914.   cycled.
  5915.  
  5916.   CYCLELIMIT=nnn
  5917.   Sets the speed of color cycling. Technically, the number of DAC
  5918.   registers updated during a single vertical refresh cycle. Legal values
  5919.   are 1 - 256, default is 55.
  5920.  
  5921.   TEXTCOLORS=mono
  5922.   Set text screen colors to simple black and white.
  5923.  
  5924.                       Fractint Version 19.2                       Page 108
  5925.  
  5926.   TEXTCOLORS=aa/bb/cc/...
  5927.   Set text screen colors. Omit any value to use the default (e.g.
  5928.   textcolors=////50 to set just the 5th value). Each value is a 2 digit
  5929.   hexadecimal value; 1st digit is background color (from 0 to 7), 2nd
  5930.   digit is foreground color (from 0 to F).
  5931.   Color values are:
  5932.       0 black     8 gray
  5933.       1 blue      9 light blue
  5934.       2 green     A light green
  5935.       3 cyan      B light cyan
  5936.       4 red       C light red
  5937.       5 magenta   D light magenta
  5938.       6 brown     E yellow
  5939.       7 white     F bright white
  5940.   31 colors can be specified, their meanings are as follows:
  5941.     heading:
  5942.       1  Fractint version info
  5943.       2  heading line development info (not used in released version)
  5944.     help:
  5945.       3  sub-heading
  5946.       4  main text
  5947.       5  instructions at bottom of screen
  5948.       6  hotlink field
  5949.       7  highlighted (current) hotlink
  5950.     menu, selection boxes, parameter input boxes:
  5951.       8  background around box and instructions at bottom
  5952.       9  emphasized text outside box
  5953.      10  low intensity information in box
  5954.      11  medium intensity information in box
  5955.      12  high intensity information in box (e.g. heading)
  5956.      13  current keyin field
  5957.      14  current keyin field when it is limited to one of n values
  5958.      15  current choice in multiple choice list
  5959.      16  speed key prompt in multiple choice list
  5960.      17  speed key keyin in multiple choice list
  5961.     general (tab key display, IFS parameters, "thinking" display):
  5962.      18  high intensity information
  5963.      19  medium intensity information
  5964.      20  low intensity information
  5965.      21  current keyin field
  5966.     disk video:
  5967.      22  background around box
  5968.      23  high intensity information
  5969.      24  low intensity information
  5970.     diagnostic messages:
  5971.      25  error
  5972.      26  information
  5973.     credits screen:
  5974.      27  bottom lines
  5975.      28  high intensity divider line
  5976.      29  low intensity divider line
  5977.      30  primary authors
  5978.      31  contributing authors
  5979.   The default is
  5980.      textcolors=1F/1A/2E/70/28/71/31/78/70/17/1F/1E/2F/3F/5F/07/
  5981.                 0D/71/70/78/0F/70/0E/0F/4F/20/17/20/28/0F/07
  5982.  
  5983.                       Fractint Version 19.2                       Page 109
  5984.  
  5985.   (In a real command file, all values must be on one line.)
  5986.   OLDDEMMCOLORS=yes|no
  5987.   Sets the coloring scheme used with the distance estimator method to the
  5988.   pre-version 16 scheme.
  5989.  
  5990.  
  5991.  5.10 Doodad Parameters
  5992.  
  5993.   LOGMAP=yes|old|n
  5994.   Selects a compressed relationship between escape-time iterations and
  5995.   palette colors.  See "Logarithmic Palettes and Color Ranges" (p. 77)
  5996.   for details.
  5997.  
  5998.   RANGES=nn/nn/nn/...
  5999.   Specifies ranges of escape-time iteration counts to be mapped to each
  6000.   color number.  See "Logarithmic Palettes and Color Ranges" (p. 77) for
  6001.   details.
  6002.  
  6003.   DISTEST=nnn/nnn
  6004.   A nonzero value in the first parameter enables the distance estimator
  6005.   method. The second parameter specifies the "width factor", defaults to
  6006.   71.  See "Distance Estimator Method" (p. 74) for details.
  6007.  
  6008.   DECOMP=2|4|8|16|32|64|128|256
  6009.   Invokes the corresponding decomposition coloring scheme.  See
  6010.   Decomposition (p. 76) for details.
  6011.  
  6012.   BIOMORPH=nnn
  6013.   Turn on biomorph option; set affected pixels to color nnn.  See
  6014.   Biomorphs (p. 78) for details.
  6015.  
  6016.   POTENTIAL=maxcolor[/slope[/modulus[/16bit]]]
  6017.   Enables the "continuous potential" coloring mode for all fractal types
  6018.   except plasma clouds, attractor types such as lorenz, and IFS. The four
  6019.   arguments define the maximum color value, the slope of the potential
  6020.   curve, the modulus "bailout" value, and whether 16 bit values are to be
  6021.   calculated.  Example: "POTENTIAL=240/2000/40/16bit". The Mandelbrot and
  6022.   Julia types ignore the modulus bailout value and use their own hardwired
  6023.   value of 4.0 instead.  See Continuous Potential (p. 79) for details.
  6024.  
  6025.   INVERT=nn/nn/nn
  6026.   Turns on inversion. The parameters are radius of inversion, x-coordinate
  6027.   of center, and y-coordinate of center. -1 as the first parameter sets
  6028.   the radius to 1/6 the smaller screen dimension; no x/y parameters
  6029.   defaults to center of screen. The values are displayed with the <Tab>
  6030.   command.  See Inversion (p. 76) for details.
  6031.  
  6032.   FINATTRACT=no|yes
  6033.   Another option to show coloring inside some Julia "lakes" to show escape
  6034.   time to finite attractors. Works with lambda, magnet types, and possibly
  6035.   others.  See Finite Attractors (p. 152) for more information.
  6036.  
  6037.   EXITNOASK=yes
  6038.   This option forces Fractint to bypass the final "are you sure?" exit
  6039.   screen when the ESCAPE key is pressed from the main image-generation
  6040.   screen.  Added at the request of Ward Christensen.  It's his funeral
  6041.  
  6042.                       Fractint Version 19.2                       Page 110
  6043.  
  6044.   <grin>.
  6045.  
  6046.  
  6047.  5.11 File Parameters
  6048.  
  6049.   In Fractint you can use various filename variables to specify files, set
  6050.   default directories, or both. For example, in the SAVENAME description
  6051.   below, [name] can be a filename, a directory name, or a fully qualified
  6052.   pathname plus filename. You can specify default directories using these
  6053.   variables in your SSTOOLS.INI file.
  6054.  
  6055.   SAVENAME=[name]
  6056.   Set the filename to use when you <S>ave a screen. The default filename
  6057.   is FRACT001. The .GIF extension is optional (Example: SAVENAME=myfile)
  6058.  
  6059.   OVERWRITE=no|yes
  6060.   Sets the savename overwrite flag (default is 'no'). If 'yes', saved
  6061.   files will over-write existing files from previous sessions; otherwise
  6062.   the automatic incrementing of FRACTnnn.GIF will find the first unused
  6063.   filename.
  6064.  
  6065.   SAVETIME=nnn
  6066.   Tells Fractint to automatically do a save every nnn minutes while a
  6067.   calculation is in progress.  This is mainly useful with long batches -
  6068.   see Batch Mode (p. 120).
  6069.   GIF87a=YES
  6070.   Backward-compatibility switch to force creation of GIF files in the
  6071.   GIF87a format. As of version 14, Fractint defaults to the new GIF89a
  6072.   format which permits storage of fractal information within the format.
  6073.   GIF87a=YES is only needed if you wish to view Fractint images with a GIF
  6074.   decoder that cannot accept the newer format.  See GIF Save File Format
  6075.   (p. 166).
  6076.  
  6077.   DITHER=YES
  6078.   Dither a color file into two colors for display on a b/w display.  This
  6079.   give a poor-quality display of gray levels.  Note that if you have a 2-
  6080.   color display, you can create a 256-color gif with disk video and then
  6081.   read it back in dithered.
  6082.  
  6083.   PARMFILE=[parmfilename]
  6084.   Specifies the default parameter file to be used by the <@> (or <2>) and
  6085.   <B> commands.  If not specified, the default is FRACTINT.PAR.
  6086.  
  6087.   FORMULAFILE=[formulafilename]
  6088.   Specifies the formula file for type=formula fractals (default is
  6089.   FRACTINT.FRM).  Handy if you want to generate one of these fractal types
  6090.   in batch mode.
  6091.  
  6092.   LFILE=[lsystemfile]
  6093.   Specifies the default L-System file for type=lsystem fractals (if not
  6094.   FRACTINT.L).
  6095.  
  6096.   IFSFILE=[ifsfilename]
  6097.   Specifies the default file for type=ifs fractals (default is
  6098.   FRACTINT.IFS).
  6099.  
  6100.                       Fractint Version 19.2                       Page 111
  6101.  
  6102.   FILENAME=[.suffix]
  6103.   Sets the default file extension used for the <r> command.  When this
  6104.   parameter is omitted, the default file mask shows .GIF and .POT files.
  6105.   You might want to specify this parameter and the SAVENAME= parameter in
  6106.   your SSTOOLS.INI file if you keep your fractal images separate from
  6107.   other .GIF files by using a different suffix for them.
  6108.  
  6109.   ORBITSAVE=yes
  6110.   Causes the file ORBITS.RAW to be opened and the points generated by
  6111.   orbit fractals or IFS fractals to be saved in a raw format. This file
  6112.   can be read by the Acrospin program which can rotate and scale the image
  6113.   rapidly in response to cursor-key commands. The filename ORBITS.RAW is
  6114.   fixed and will be overwritten each time a new fractal is generated with
  6115.   this option.
  6116.   (see Barnsley IFS Fractals (p. 43) Orbit Fractals (p. 50) Acrospin
  6117.   (p. 171));
  6118.  
  6119.  
  6120.  5.12 Video Parameters
  6121.  
  6122.   VIDEO=xxx
  6123.   Set the initial video mode (and bypass the informational screens). Handy
  6124.   for batch runs. (Example: VIDEO=F4 for IBM 16-color VGA.)  You can
  6125.   obtain the current VIDEO= values (key assignments) from the "select
  6126.   video mode" screens inside Fractint. If you want to do a batch run with
  6127.   a video mode which isn't currently assigned to a key, you'll have to
  6128.   modify the key assignments - see "Video Mode Function Keys" (p. 28).
  6129.  
  6130.   ASKVIDEO=yes|no
  6131.   If "no," this eliminates the prompt asking you if a file to be restored
  6132.   is OK for your current video hardware.
  6133.   WARNING: every version of Fractint so far has had a bigger, better, but
  6134.   shuffled-around video table. Since calling for a mode your hardware
  6135.   doesn't support can leave your system in limbo, be careful about leaving
  6136.   the above two parameters in a command file to be used with future
  6137.   versions of Fractint, particularly for the super-VGA modes.
  6138.  
  6139.  
  6140.   ADAPTER=hgc|cga|ega|egamono|mcga|vga|ATI|Everex|Trident|NCR|Video7|Genoa|
  6141.           Paradise|Chipstech|Tseng3000|Tseng4000|AheadA|AheadB|Oaktech
  6142.   Bypasses Fractint's internal video autodetect logic and assumes that the
  6143.   specified kind of adapter is present. Use this parameter only if you
  6144.   encounter video problems without it.  Specifying adapter=vga with an
  6145.   SVGA adapter will make its extended modes unusable with Fractint.  All
  6146.   of the options after the "VGA" option specify specific SuperVGA chipsets
  6147.   which are capable of video resolutions higher than that of a "vanilla"
  6148.   VGA adapter.  Note that Fractint cares about the Chipset your adapter
  6149.   uses internally, not the name of the company that sold it to you.
  6150.  
  6151.   VESADETECT=yes|no
  6152.   Specify no to bypass VESA video detection logic. Try this if you
  6153.   encounter video problems with a VESA compliant video adapter or driver.
  6154.  
  6155.   AFI=yes|8514|no
  6156.   Normally, when you attempt to use an 8514/A-specific video mode,
  6157.   Fractint first attempts to detect the presence of an 8514/A register-
  6158.  
  6159.                       Fractint Version 19.2                       Page 112
  6160.  
  6161.   compatible adapter.  If it fails to find one, it then attempts to detect
  6162.   the presence of an 8514/A-compatible API (IE, IBM's HDILOAD or its
  6163.   equivalent).  Fractint then uses either its register-compatible or its
  6164.   API-compatible video logic based on the results of those tests.  If you
  6165.   have an "8514/A-compatible" video adapter that passes Fractint's
  6166.   register-compatible detection logic but doesn't work correctly with
  6167.   Fractint's register-compatible video logic, setting "afi=yes" will force
  6168.   Fractint to bypass the register-compatible code and look only for the
  6169.   API interface.
  6170.  
  6171.   TEXTSAFE=yes|no|bios|save
  6172.   When you switch from a graphics image to text mode (e.g. when you use
  6173.   <F1> while a fractal is on display), Fractint remembers the graphics
  6174.   image, and restores it when you return from the text mode.  This should
  6175.   be no big deal - there are a number of well-defined ways Fractint could
  6176.   do this which *should* work on any video adapter.  They don't - every
  6177.   fast approach we've tried runs into a bug on one video adapter or
  6178.   another.  So, we've implemented a fast way which works on most adapters
  6179.   in most modes as the default, and added this parameter for use when the
  6180.   default approach doesn't work.
  6181.   If you experience the following problems, please fool around with this
  6182.   parameter to try to fix the problem:
  6183.     o Garbled image, or lines or dashes on image, when returning to image
  6184.       after going to menu, <tab> display, or help.
  6185.     o Blank screen when starting Fractint.
  6186.   The problems most often occur in higher resolution modes. We have not
  6187.   encountered them at all in modes under 320x200x256 - for those modes
  6188.   Fractint always uses a fast image save/restore approach.
  6189.   Textsafe options:
  6190.     yes: This is the default. When switching to/from graphics, Fractint
  6191.       saves just that part of video memory which EGA/VGA adapters are
  6192.       supposed to modify during the mode changes.
  6193.     no: This forces use of monochrome 640x200x2 mode for text displays
  6194.       (when there is a high resolution graphics image to be saved.) This
  6195.       choice is fast but uses chunky and colorless characters. If it turns
  6196.       out to be the best choice for you, you might want to also specify
  6197.       "textcolors=mono" for a more consistent appearance in text screens.
  6198.     bios: This saves memory in the same way as textsafe=yes, but uses the
  6199.       adapter's BIOS routines to save/restore the graphics state.  This
  6200.       approach is fast and ought to work on all adapters. Sadly, we've
  6201.       found that very few adapters implement this function perfectly.
  6202.     save: This is the last choice to try. It should work on all adapters
  6203.       in all modes but it is slow. It tells Fractint to save/restore the
  6204.       entire image. Expanded or extended memory is used for the save if
  6205.       you have enough available; otherwise a temporary disk file is used.
  6206.       The speed of textsafe=save will be acceptable on some machines but
  6207.       not others.  The speed depends on:
  6208.         o Cpu and video adapter speed.
  6209.         o Whether enough expanded or extended memory is available.
  6210.         o Video mode of image being remembered. A few special modes are
  6211.           *very* slow compared to the rest. The slow ones are: 2 and 4 color
  6212.           modes with resolution higher than 640x480; custom modes for ATI
  6213.           EGA Wonder, Paradise EGA-480, STB, Compaq portable 386, AT&T 6300,
  6214.           and roll-your-own video modes implemented with customized
  6215.           "yourvid.c" code.
  6216.   If you want to tune Fractint to use different "textsafe" options for
  6217.  
  6218.                       Fractint Version 19.2                       Page 113
  6219.  
  6220.   different video modes, see "Customized Video Modes, FRACTINT.CFG"
  6221.   (p. 126).  (E.g. you might want to use the slower textsafe=save approach
  6222.   just for a few high-resolution modes which have problems with
  6223.   textsafe=yes.)
  6224.  
  6225.   EXITMODE=nn
  6226.   Sets the bios-supported videomode to use upon exit to the specified
  6227.   value.  nn is in hexadecimal.  The default is 3, which resets to 80x25
  6228.   color text mode on exit. With Hercules Graphics Cards, and with
  6229.   monochrome EGA systems, the exit mode is always 7 and is unaffected by
  6230.   this parameter.
  6231.  
  6232.   TPLUS=yes|no
  6233.   For TARGA+ adapters. Setting this to 'no' pretends a TARGA+ is NOT
  6234.   installed.
  6235.  
  6236.   NONINTERLACED=yes|no
  6237.   For TARGA+ adapters. Setting this to 'yes' will configure the adapter to
  6238.   a non-interlaced mode whenever possible.  It should only be used with a
  6239.   multisynch monitor. The default is no, i.e. interlaced.
  6240.  
  6241.   MAXCOLORRES=8|16|24
  6242.   For TARGA+ adapters. This determines the number of bits to use for color
  6243.   resolution.  8 bit color is equivalent to VGA color resolution. The 16
  6244.   and 24 bit color resolutions are true color video modes which are not
  6245.   yet supported by Fractint but are hopefully coming soon.
  6246.  
  6247.   PIXELZOOM=0|1|2|3
  6248.   For TARGA+ adapters. Lowers the video mode resolution by powers of 2.
  6249.   For example, the 320x200 video resolution on the TARGA+ is actually the
  6250.   640x400 video mode with a pixel zoom of 1.  Using the 640x400 video mode
  6251.   with a zoom of 3 would lower the resolution by 8, which is 2 raised to
  6252.   the 3rd power, for a full screen resolution of 80x50 pixels.
  6253.  
  6254.   VIEWWINDOWS=xx[/xx[/yes|no[/nn[/nn]]]] Set the reduction factor, final
  6255.   media aspect ratio, crop starting coordinates (y/n), explicit x size,
  6256.   and explicit y size, see "View Window" (p. 26).
  6257.  
  6258.  
  6259.  5.13 Sound Parameters
  6260.  
  6261.   SOUND=off|x|y|z
  6262.   We're all MUCH too busy to waste time with Fractint at work, and no
  6263.   doubt you are too, so "sound=off" is included only for use at home, to
  6264.   avoid waking the kids or your Significant Other, late at night. (By the
  6265.   way, didn't you tell yourself "just one more zoom on LambdaSine" an hour
  6266.   ago?)  Suggestions for a "boss" hot-key will be cheerfully ignored, as
  6267.   this sucker is getting big enough without including a spreadsheet screen
  6268.   too.  The "sound=x/y/x" options are for the "attractor" fractals, like
  6269.   the Lorenz fractals - they play with the sound on your PC speaker as
  6270.   they are generating an image, based on the X or Y or Z co-ordinate they
  6271.   are displaying at the moment.  At the moment, "sound=x" (or y or z)
  6272.   really doesn't work very well when using an integer algorithm - try it
  6273.   with the floating-point toggle set, instead.
  6274.  
  6275.                       Fractint Version 19.2                       Page 114
  6276.  
  6277.   The scope of the sound command has been extended. You can now hear the
  6278.   sound of fractal orbits--just turn on sound from the command line or the
  6279.   <X> menu, fire up a fractal, and try the <O>rbits command. Use the
  6280.   orbitdelay=<nnn> command (also on the <X> menu) to dramatically alter
  6281.   the effect, which ranges from an unearthly scream to a series of
  6282.   discrete tones. Not recommended when people you have to live with are
  6283.   nearby!  Remember, we don't promise that it will sound beautiful!
  6284.  
  6285.   You can also "hear" any image that Fractint can decode; turn on sound
  6286.   before using <R> to read in a GIF file. We have no idea if this feature
  6287.   is useful. It was inspired by the comments of an on-line friend who is
  6288.   blind. We solicit feedback and suggestions from anyone who finds these
  6289.   sound features interesting or useful. The orbitdelay command also
  6290.   affects the sound of decoding images.
  6291.  
  6292.   HERTZ=nnn
  6293.   Adjusts the sound produced by the "sound=x/y/z" option.  Legal values
  6294.   are 20 through 15000.
  6295.  
  6296.  
  6297.  5.14 Printer Parameters
  6298.  
  6299.   PRINTER=type[/resolution[/port#]]
  6300.   Defines your printer setup. The SSTOOLS.INI file is a REAL handy place
  6301.   to put this option, so that it's available whenever you have that
  6302.   sudden, irresistible urge for hard copy.
  6303.   Printer types:
  6304.     IB  IBM-compatible (default)
  6305.     EP  Epson-compatible
  6306.     HP  LaserJet
  6307.     CO  Star Micronics Color printer, supposedly Epson-color-compatible
  6308.     PA  Paintjet
  6309.     PS  PostScript
  6310.     PSL Postscript, landscape mode
  6311.     PL  Plotter using HP-GL
  6312.   Resolution:
  6313.     In dots per inch.
  6314.     Epson/IBM: 60, 120, 240
  6315.     LaserJet: 75, 150, 300
  6316.     PaintJet: 90, 180
  6317.     PostScript: 10 through 600, or special value 0 to print full page to
  6318.     within about .4" of the edges (in portrait mode, width is full page and
  6319.     height is adjusted to 3:4 aspect ratio)
  6320.     Plotter: 1 to 10 for 1/Nth of page (e.g. 2 for 1/2 page)
  6321.   Port:
  6322.     1, 2, 3 for LPT1-3 via BIOS
  6323.     11, 12, 13, 14 for COM1-4 via BIOS
  6324.     21, 22 for LPT1 or LPT2 using direct port access (faster when it works)
  6325.     31, 32 for COM1 or COM2 using direct port access
  6326.  
  6327.   COMPORT=port/baud/options
  6328.   Serial printer port initialization.
  6329.   Port=1,2,3,etc.
  6330.   Baud=115,150,300,600,1200,2400,4800,9600
  6331.   Options: 7,8 | 1,2 | e,n,o (any order).
  6332.   Example: comport=1/9600/n81 for COM1 set to 9600, no parity, 8 bits per
  6333.  
  6334.                       Fractint Version 19.2                       Page 115
  6335.  
  6336.   character, 1 stop bit.
  6337.  
  6338.   LINEFEED=crlf|lf|cr
  6339.   Specifies the control characters to emit at end of each line:  carriage
  6340.   return and linefeed, just linefeed, or just carriage return.  The
  6341.   default is crlf.
  6342.  
  6343.   TITLE=yes
  6344.   If specified, title information is added to printouts.
  6345.  
  6346.   PRINTFILE=filename
  6347.   Causes output data for the printer to be written to the named file on
  6348.   disk instead of to a printer port. The filename is incremented by 1 each
  6349.   time an image is printed - e.g. if the name is FRAC01.PRN, the second
  6350.   print operation writes to FRAC02.PRN, etc. Existing files are not
  6351.   overwritten - if the file exists, the filename is incremented to a new
  6352.   name.
  6353.  
  6354.  
  6355.  5.15 PostScript Parameters
  6356.  
  6357.   EPSF=1|2|3
  6358.   Forces print-to-file and PostScript. If PRINTFILE is not specified, the
  6359.   default filename is FRACT001.EPS. The number determines how 'well-
  6360.   behaved' a .EPS file is. 1 means by-the-book. 2 allows some EPS 'no-nos'
  6361.   like settransfer and setscreen - BUT includes code that should make the
  6362.   code still work without affecting the rest of the non-EPS document. 3 is
  6363.   a free-for-all.
  6364.  
  6365.   COLORPS=YES|NO - Enable or disable the color extensions.
  6366.  
  6367.   RLEPS=YES|NO
  6368.   Enable or disable run length encoding of the PostScript file.  Run
  6369.   length encoding will make the PostScript file much smaller, but it may
  6370.   take longer to print.  The run length encoding code is based on pnmtops,
  6371.   which is copyright (C) 1989 by Jef Poskanzer, and carries the following
  6372.   notice: "Permission to use, copy, modify, and distribute this software
  6373.   and its documentation for any purpose and without fee is hereby granted,
  6374.   provided that the above copyright notice appear in all copies and that
  6375.   both that copyright notice and this permission notice appear in
  6376.   supporting documentation.  This software is provided "as is" without
  6377.   express or implied warranty."
  6378.  
  6379.   TRANSLATE=yes|-n|n
  6380.   Translate=yes prints the negative image of the fractal.  Translate=n
  6381.   reduces the image to that many colors. A negative value causes a color
  6382.   reduction as well as a negative image.
  6383.  
  6384.   HALFTONE=frq/ang/sty[/f/a/s/f/a/s/f/a/s]
  6385.   Tells the PostScript printer how to define its halftone screen. The
  6386.   first value, frequency, defines the number of halftone lines per inch.
  6387.   The second chooses the angle (in degrees) that the screen lies at. The
  6388.   third option chooses the halftone 'spot' style. Good default frequencies
  6389.   are between 60 and 80; Good default angles are 45 and 0; the default
  6390.   style is 0. If the halftone= option is not specified, Fractint will
  6391.   print using the printer's default halftone screen, which should have
  6392.  
  6393.                       Fractint Version 19.2                       Page 116
  6394.  
  6395.   been already set to do a fine job on the printer.
  6396.  
  6397.   These are the only three used when colorps=no. When color PS printing is
  6398.   being used, the other nine options specify the red, green, then blue
  6399.   screens. A negative number in any of these places will cause it to use
  6400.   the previous (or default) value for that parameter. NOTE: Especially
  6401.   when using color, the built-in screens in the printer's ROM may be the
  6402.   best choice for printing.
  6403.   The default values are as follows:
  6404.   halftone=45/45/1/45/75/1/45/15/1/45/0/1 and these will be used if
  6405.   Fractint's halftone is chosen over the printer's built-in screen.
  6406.  
  6407.   Current halftone styles:
  6408.       0 Dot
  6409.       1 Dot (Smoother)
  6410.       2 Dot (Inverted)
  6411.       3 Ring (Black)
  6412.       4 Ring (White)
  6413.       5 Triangle (Right)
  6414.       6 Triangle (Isosceles)
  6415.       7 Grid
  6416.       8 Diamond
  6417.       9 Line
  6418.      10 Microwaves
  6419.      11 Ellipse
  6420.      12 Rounded Box
  6421.      13 Custom
  6422.      14 Star
  6423.      15 Random
  6424.      16 Line (slightly different)
  6425.  
  6426.   A note on device-resolution black and white printing
  6427.   ----------------------------------------------------
  6428.  
  6429.   This mode of printing can now be done much more quickly, and takes a lot
  6430.   less file space. Just set EPSF=0 PRINTER=PSx/nnn COLORPS=NO RLEPS=YES
  6431.   TRANSLATE=m, where x is P or L for portrait/landscape, nnn is your
  6432.   printer's resolution, m is 2 or -2 for positive or negative printing
  6433.   respectively. This combination of parameters will print exactly one
  6434.   printer pixel per each image pixel and it will keep the proportions of
  6435.   the picture, if both your screen and printer have square pixels (or the
  6436.   same pixel-aspect). Choose a proper (read large) window size to fill as
  6437.   much of the paper as possible for the most spectacular results.  2048 by
  6438.   2048 is barely enough to fill the width of a letter size page with 300
  6439.   dpi printer resolution.  For higher resolution printers, you will wish
  6440.   fractint supported larger window sizes (hint, hint...). Bug reports
  6441.   and/or suggestions should be forwarded to Yavuz Onder through e-mail
  6442.   (yavuz@bnr.ca).
  6443.  
  6444.   A word from the author (Scott Taylor)
  6445.   -------------------------------------
  6446.  
  6447.   Color PostScript printing is new to me. I don't even have a color
  6448.   printer to test it on. (Don't want money. Want a Color PostScript
  6449.   printer!) The initial tests seem to have worked. I am still testing and
  6450.   don't know whether or not some sort of gamma correction will be needed.
  6451.  
  6452.                       Fractint Version 19.2                       Page 117
  6453.  
  6454.   I'll have to wait and see about that one.
  6455.  
  6456.  
  6457.  5.16 PaintJet Parameters
  6458.  
  6459.   Note that the pixels printed by the PaintJet are square.  Thus, a
  6460.   printout of an image created in a video mode with a 4:3 pixel ratio
  6461.   (such as 640x480 or 800x600) will come out matching the screen; other
  6462.   modes (such as 320x200) will come out stretched.
  6463.  
  6464.   Black and white images, or images using the 8 high resolution PaintJet
  6465.   colors, come out very nicely.  Some images using the full spectrum of
  6466.   PaintJet colors are very nice, some are disappointing.
  6467.  
  6468.   When 180 dots per inch is selected (in PRINTER= command), high
  6469.   resolution 8 color printing is done.  When 90 dpi is selected, low
  6470.   resolution printing using the full 330 dithered color palette is done.
  6471.   In both cases, Fractint starts by finding the nearest color supported by
  6472.   the PaintJet for each color in your image.  The translation is then
  6473.   displayed (unless the current display mode is disk video).  This display
  6474.   *should* be a fairly good match to what will be printed - it won't be
  6475.   perfect most of the time but should give some idea of how the output
  6476.   will look.  At this point you can <Enter> to go ahead and print, <Esc>
  6477.   to cancel, or <k> to cancel and keep the adjusted colors.
  6478.  
  6479.   Note that you can use the color map PAINTJET.MAP to create images which
  6480.   use the 8 high resolution colors available on the PaintJet.  Also, two
  6481.   high-resolution disk video modes are available for creating full page
  6482.   images.
  6483.  
  6484.   If you find that the preview image seems very wrong (doesn't match what
  6485.   actually gets printed) or think that Fractint could be doing a better
  6486.   job of picking PaintJet colors to match your image's colors, you can try
  6487.   playing with the following parameter.  Fair warning: this is a very
  6488.   tricky business and you may find it a very frustrating business trying
  6489.   to get it right.
  6490.  
  6491.   HALFTONE=r/g/b
  6492.   (The parameter name is not appropriate - we appropriated a PostScript
  6493.   parameter for double duty here.)
  6494.   This separately sets the "gamma" adjustment for each of the red, green,
  6495.   and blue color components.  Think of "gamma" as being like the contrast
  6496.   adjustment on your screen.  Higher gamma values for all three components
  6497.   results in colors with more contrast being produced on the printer.
  6498.   Since each color component can have its gamma separately adjusted, you
  6499.   can change the resulting color mix subtly (or drastically!)
  6500.   Each gamma value entered has one implied decimal digit.
  6501.   The default is "halftone=21/19/16", for red 2.1, green 1.9, and blue
  6502.   1.6.  (A note from Pieter Branderhorst: I wrote this stuff to come out
  6503.   reasonably on my monitor/printer.  I'm a bit suspicious of the guns on
  6504.   my monitor; if the colors seem ridiculously wrong on your system you
  6505.   might start by trying halftone=17/17/17.)
  6506.  
  6507.                       Fractint Version 19.2                       Page 118
  6508.  
  6509.  5.17 Plotter Parameters
  6510.  
  6511.   Plotters which understand HP-GL commands are supported. To use a
  6512.   plotter, draw a SMALL image (32x20 or 64x40) using the <v>iew screen
  6513.   options.  Put a red pen in the first holder in the plotter, green in the
  6514.   second, blue in the third.  Now press <P> to start plotting.  Now get a
  6515.   cup of coffee...  or two... or three.  It'll take a while to plot.
  6516.   Experiment with different resolutions, plot areas, plotstyles, and even
  6517.   change pens to create weird-colored images.
  6518.  
  6519.   PLOTSTYLE=0|1|2
  6520.   0: 3 parallel lines (red/green/blue) are drawn for each pixel, arranged
  6521.     like "///".  Each bar is scaled according to the intensity of the
  6522.     corresponding color in the pixel.  Using different pen colors (e.g.
  6523.     blue, green, violet) can come out nicely.  The trick is to not tell
  6524.     anyone what color the bars are supposed to represent and they will
  6525.     accept these plotted colors because they do look nice...
  6526.   1: Same as 0, but the lines are also twisted.  This removes some of the
  6527.     'order' of the image which is a nice effect.  It also leaves more
  6528.     whitespace making the image much lighter, but colors such as yellow
  6529.     are actually visible.
  6530.   2: Color lines are at the same angle and overlap each other.  This type
  6531.     has the most whitespace.  Quality improves as you increase the number
  6532.     of pixels squeezed into the same size on the plotter.
  6533.  
  6534.  
  6535.  5.18 3D Parameters
  6536.  
  6537.   To stay out of trouble, specify all the 3D parameters, even if you want
  6538.   to use what you think are the default values. It takes a little practice
  6539.   to learn what the default values really are. The best way to create a
  6540.   set of parameters is to use the <B> command on an image you like and
  6541.   then use an editor to modify the resulting parameter file.
  6542.  
  6543.   3D=Yes
  6544.   3D=Overlay
  6545.   Resets all 3d parameters to default values. If FILENAME= is given,
  6546.   forces a restore to be performed in 3D mode (handy when used with
  6547.   'batch=yes' for batch-mode 3D images). If specified, 3D=Yes should come
  6548.   before any other 3d parameters on the command line or in a parameter
  6549.   file entry. The form 3D=Overlay is identical except that the previous
  6550.   graphics screen is not cleared, as with the <#> (<shift-3> on some
  6551.   keyboards) overlay command.  Useful for building parameter files that
  6552.   use the 3D overlay feature.
  6553.  
  6554.   The options below override the 3D defaults:
  6555.   PREVIEW=yes                Turns on 3D 'preview' default mode
  6556.   SHOWBOX=yes                Turns on 3D 'showbox' default mode
  6557.   COARSE=nn                  Sets Preview 'coarseness' default value
  6558.   SPHERE=yes                 Turns on spherical projection mode
  6559.   STEREO=n                   Selects the type of stereo image creation
  6560.   RAY=nnn                    selects raytrace output file format
  6561.   BRIEF=yes                  selects brief or verbose file for DKB output
  6562.   USEGRAYSCALE=yes           use grayscale as depth instead of color number
  6563.  
  6564.                       Fractint Version 19.2                       Page 119
  6565.  
  6566.   INTEROCULAR=nn             Sets the interocular distance for stereo
  6567.   CONVERGE=nn                Determines the overall image separation
  6568.   CROP=nn/nn/nn/nn           Trims the edges off stereo pairs
  6569.   BRIGHT=nn/nn               Compensates funny glasses filter parameters
  6570.   LONGITUDE=nn/nn            Longitude minimum and maximum
  6571.   LATITUDE=nn/nn             Latitude minimum and maximum
  6572.   RADIUS=nn                  Radius scale factor
  6573.   ROTATION=nn[/nn[/nn]]      Rotation about x,y, and z axes
  6574.   SCALEZYZ=nn/nn/nn          X,y,and z scale factors
  6575.   ROUGHNESS=nn               Same as z scale factor
  6576.   WATERLINE=nn               Colors nn and below will be "inside" color
  6577.   FILLTYPE=nn                3D filltype
  6578.   PERSPECTIVE=nn             Perspective distance
  6579.   XYSHIFT=nn/nn              Shift image in x and y directions with
  6580.                               perspective
  6581.   LIGHTSOURCE=nn/nn/nn       Coordinates for light-source vector
  6582.   SMOOTHING=nn               Smooths images in light-source fill modes
  6583.   TRANSPARENT=min/max        Defines a range of colors to be treated as
  6584.                               "transparent" when <#>Overlaying 3D images.
  6585.   XYADJUST=nn/nn             This shifts the image in the x/y dir without
  6586.                               perspective
  6587.  
  6588.   Below are new commands as of version 14 that support Marc Reinig's
  6589.   terrain features.
  6590.  
  6591.   RANDOMIZE=nnn (0 - 100)
  6592.   This feature randomly varies the color of a pixel to near by colors.
  6593.   Useful to minimize map banding in 3d transformations. Usable with all
  6594.   FILLTYPES. 0 disables, max values is 7. Try 3 - 5.
  6595.  
  6596.   AMBIENT=nnn (0 - 100)
  6597.   Set the depth of the shadows when using full color and light source
  6598.   filltypes. "0" disables the function, higher values lower the contrast.
  6599.  
  6600.   FULLCOLOR=yes
  6601.   Valid with any light source FILLTYPE. Allows you to create a Targa-24
  6602.   file which uses the color of the image being transformed or the map you
  6603.   select and shades it as you would see it in real life. Well, its better
  6604.   than B&W.  A good map file to use is topo
  6605.  
  6606.   HAZE=nnn (0 - 100)
  6607.   Gives more realistic terrains by setting the amount of haze for distant
  6608.   objects when using full color in light source FILLTYPES. Works only in
  6609.   the "y" direction currently, so don't use it with much y rotation. Try
  6610.   "rotation=85/0/0". 0 disables.
  6611.  
  6612.   LIGHTNAME=<filename>
  6613.   The name of the Targa-24 file to be created when using full color with
  6614.   light source. Default is light001.tga. If overwrite=no (the default),
  6615.   the file name will be incremented until an unused filename is found.
  6616.   Background in this file will be sky blue.
  6617.  
  6618.   MONITORWIDTH=<nnn>
  6619.   This parameter allows you to specify the width in inches of the image on
  6620.   your monitor for the purpose of getting the correct stereo effect when
  6621.   viewing RDS images. See Random Dot Stereograms (RDS) (p. 82).
  6622.  
  6623.                       Fractint Version 19.2                       Page 120
  6624.  
  6625.  5.19 Batch Mode
  6626.  
  6627.   It IS possible, believe it or not, to become so jaded with the screen
  6628.   drawing process, so familiar with the types and options, that you just
  6629.   want to hit a key and do something else until the final images are safe
  6630.   on disk.  To do this, start Fractint with the BATCH=yes parameter.  To
  6631.   set up a batch run with the parameters required for a particular image
  6632.   you might:
  6633.     o Find an interesting area.  Note the parameters from the <Tab>
  6634.       display.  Then use an editor to write a batch file.
  6635.     o Find an interesting area.  Set all the options you'll want in the
  6636.       batch run.  Use the <B> command to store the parameters in a file.
  6637.       Then use an editor to add the additional required batch mode
  6638.       parameters (such as VIDEO=) to the generated parameter file entry.
  6639.       Then run the batch using "fractint @myname.par/myentry" (if you told
  6640.       the <B> command to use file "myname" and to name the entry
  6641.       "myentry").
  6642.  
  6643.   Another approach to batch mode calculations, using "FILENAME=" and
  6644.   resume, is described later.
  6645.  
  6646.   When modifying a parameter file entry generated by the <B> command, the
  6647.   only parameters you must add for a batch mode run are "BATCH=yes", and
  6648.   "VIDEO=xxx" to select a video mode.  You might want to also add
  6649.   "SAVENAME=[name]" to name the result as something other than the default
  6650.   FRACT001.GIF.  Or, you might find it easier to leave the generated
  6651.   parameter file unchanged and add these parameters by using a command
  6652.   like:
  6653.      fractint @myname.par/myentry batch=y video=AF3 savename=mygif
  6654.  
  6655.   "BATCH=yes" tells Fractint to run in batch mode -- that is, Fractint
  6656.   draws the image using whatever other parameters you specified, then acts
  6657.   as if you had hit <S> to save the image, then exits to DOS.
  6658.  
  6659.   "FILENAME=" can be used with "BATCH=yes" to resume calculation of an
  6660.   incomplete image.  For instance, you might interactively find an image
  6661.   you like; then select some slow options (a high resolution disk video
  6662.   mode, distance estimator method, high maxiter, or whatever);  start the
  6663.   calculation;  then interrupt immediately with a <S>ave.  Rename the save
  6664.   file (fract001.gif if it is the first in the session and you didn't name
  6665.   it with the <X> options or "savename=") to xxx.gif. Later you can run
  6666.   Fractint in batch mode to finish the job:
  6667.       fractint batch=yes filename=xxx savename=xxx
  6668.  
  6669.   "SAVETIME=nnn" is useful with long batch calculations, to store a
  6670.   checkpoint every nnn minutes.  If you start a many hour calculation with
  6671.   say "savetime=60", and a power failure occurs during the calculation,
  6672.   you'll have lost at most an hour of work on the image.  You can resume
  6673.   calculation from the save file as above.  Automatic saves triggered by
  6674.   SAVETIME do not increment the save file name. The same file is
  6675.   overwritten by each auto save until the image completes.  But note that
  6676.   Fractint does not directly over-write save files.  Instead, each save
  6677.   operation writes a temporary file FRACTINT.TMP, then deletes the prior
  6678.   save file, then renames FRACTINT.TMP to be the new save file.  This
  6679.   protects against power failures which occur during a save operation - if
  6680.   such a power failure occurs, the prior save file is intact and there's a
  6681.  
  6682.                       Fractint Version 19.2                       Page 121
  6683.  
  6684.   harmless incomplete FRACTINT.TMP on your disk.
  6685.  
  6686.   If you want to spread a many-hour image over multiple bits of free
  6687.   machine time you could use a command like:
  6688.       fractint batch=yes filename=xxx savename=xxx savetime=60 video=F3
  6689.   While this batch is running, hit <S> (almost any key actually) to tell
  6690.   fractint to save what it has done so far and give your machine back.  A
  6691.   status code of 2 is returned by fractint to the batch file.  Kick off
  6692.   the batch again when you have another time slice for it.
  6693.  
  6694.   While running a batch file, pressing any key will cause Fractint to exit
  6695.   with an errorlevel = 2.  Any error that interrupts an image save to disk
  6696.   will cause an exit with errorlevel = 2.  Any error that prevents an
  6697.   image from being generated will cause an exit with errorlevel = 1.
  6698.  
  6699.   The SAVETIME= parameter, and batch resumes of partial calculations, only
  6700.   work with fractal types which can be resumed.  See "Interrupting and
  6701.   Resuming" (p. 25) for information about non-resumable types.
  6702.  
  6703.  
  6704.  5.20 Browser Parameters
  6705.  
  6706.   This Screen enables you to control Fractints built in file browsing
  6707.   utility.  If you don't know what that is see Browse Commands (p. 28).
  6708.   This screen is selected with <Ctrl-B> from just about anywhere.
  6709.  
  6710.   "Autobrowsing"
  6711.   Select yes if you want the loaded image to be scanned for sub images
  6712.   immediately without pressing 'L' every time.
  6713.  
  6714.   "Ask about GIF video mode"
  6715.   Allows turning on and off the display of the video mode table when
  6716.   loading GIFs.  This has the same effect as the askvideo= command.
  6717.  
  6718.   "Type/Parm check"
  6719.   Select whether the browser tests for fractal type or parms when deciding
  6720.   whether a file is a sub image of the current screen or not. DISABLE WITH
  6721.   CAUTION! or things could get confusing. These tests can be switched off
  6722.   to allow such situations as wishing to display old images that were
  6723.   generated using a formula type which is now implemented as a built in
  6724.   fractal type.
  6725.   "Confirm deletes"
  6726.   Set this to No if you get fed up with the double prompting that the
  6727.   browser gives when deleting a file.  It won't get rid of the first
  6728.   prompt however.
  6729.  
  6730.   "Smallest window"
  6731.   This parameter determines how small the image would have to be onscreen
  6732.   before it decides not to include it in the selection of files.  The size
  6733.   is entered in decimal pixels so, for instance, this could be set to 0.2
  6734.   to allow images that are up to around three maximum zooms away
  6735.   (depending on the current video resolution) to be loaded instantly.  Set
  6736.   this to 0 to enable all sub images to be detected.  This can lead to a
  6737.   very cluttered screen!  The primary use is in conjunction with the
  6738.   search file mask (see below) to allow location of high magnification
  6739.   images within an overall view (like the whole Mset ).
  6740.  
  6741.                       Fractint Version 19.2                       Page 122
  6742.  
  6743.   "Smallest box"
  6744.   This determines when the image location is shown as crosshairs rather
  6745.   than a rather small box.  Set this according to how good your eyesight
  6746.   is (probably worse than before you started staring at fractals all the
  6747.   time :-)) or the resolution of your screen.  WARNING the crosshairs
  6748.   routine centers the cursor on one corner of the image box at the moment
  6749.   so this looks misleading if set too large.
  6750.   "Search Mask"
  6751.   Sets the file name pattern which the browser searches, this can be used
  6752.   to search out the location of a file by setting this to the filename and
  6753.   setting smallest image to 0 (see above).
  6754.  
  6755.                       Fractint Version 19.2                       Page 123
  6756.  
  6757.  6. Hardware Support
  6758.  
  6759.  
  6760.  6.1 Notes on Video Modes, "Standard" and Otherwise
  6761.  
  6762.   True to the spirit of public-domain programming, Fractint makes only a
  6763.   limited attempt to verify that your video adapter can run in the mode
  6764.   you specify, or even that an adapter is present, before writing to it.
  6765.   So if you use the "video=" command line parameter, check it before using
  6766.   a new version of Fractint - the old key combo may now call an
  6767.   ultraviolet holographic mode.
  6768.  
  6769.   EGA
  6770.  
  6771.   Fractint assumes that every EGA adapter has a full 256K of memory (and
  6772.   can therefore display 640 x 350 x 16 colors), but does nothing to verify
  6773.   that fact before slinging pixels.
  6774.  
  6775.   "TWEAKED" VGA MODES
  6776.  
  6777.   The IBM VGA adapter is a highly programmable device, and can be set up
  6778.   to display many video-mode combinations beyond those "officially"
  6779.   supported by the IBM BIOS. E.g. 320x400x256 and 360x480x256 (the latter
  6780.   is one of our favorites).  These video modes are perfectly legal, but
  6781.   temporarily reprogram the adapter (IBM or fully register-compatible) in
  6782.   a non-standard manner that the BIOS does not recognize.
  6783.  
  6784.   Fractint also contains code that sets up the IBM (or any truly register-
  6785.   compatible) VGA adapter for several extended modes such as 704x528,
  6786.   736x552, 768x576, and 800x600. It does this by programming the VGA
  6787.   controller to use the fastest dot-clock on the IBM adapter (28.322 MHz),
  6788.   throwing more pixels, and reducing the refresh rate to make up for it.
  6789.  
  6790.   These modes push many monitors beyond their rated specs, in terms of
  6791.   both resolution and refresh rate. Signs that your monitor is having
  6792.   problems with a particular "tweaked" mode include:
  6793.    o vertical or horizontal overscan (displaying dots beyond the edges of
  6794.      your visible CRT area)
  6795.    o flickering (caused by a too-slow refresh rate)
  6796.    o vertical roll or total garbage on the screen (your monitor simply
  6797.      can't keep up, or is attempting to "force" the image into a pre-set
  6798.      mode that doesn't fit).
  6799.  
  6800.   We have successfully tested the modes up to 768x576 on an IBM PS/2 Model
  6801.   80 connected to IBM 8513, IBM 8514, NEC Multisync II, and Zenith 1490
  6802.   monitors (all of which exhibit some overscan and flicker at the highest
  6803.   rates), and have tested 800x600 mode on the NEC Multisync II (although
  6804.   it took some twiddling of the vertical-size control).
  6805.  
  6806.   SUPER-EGA AND SUPER-VGA MODES
  6807.  
  6808.   Since version 12.0, we've used both John Bridges' SuperVGA Autodetecting
  6809.   logic *and* VESA adapter detection, so that many brand-specific SuperVGA
  6810.   modes have been combined into single video mode selection entries.
  6811.   There is now exactly one entry for SuperVGA 640x480x256 mode, for
  6812.   instance.
  6813.  
  6814.                       Fractint Version 19.2                       Page 124
  6815.  
  6816.   If Fractint's automatic SuperVGA/VESA detection logic guesses wrong, and
  6817.   you know which SuperVGA chipset your video adapter uses, you can use the
  6818.   "adapter=" command-line option to force Fractint to assume the presence
  6819.   of a specific SuperVGA Chipset - see Video Parameters (p. 111) for
  6820.   details.
  6821.  
  6822.   8514/A MODES
  6823.  
  6824.   The IBM 8514/A modes (640x480 and 1024x768) default to using the
  6825.   hardware registers.  If an error occurs when trying to open the adapter,
  6826.   an attempt will be made to use IBM's software interface, and requires
  6827.   the preloading of IBM's HDILOAD TSR utility.
  6828.  
  6829.   The Adex 1280x1024 modes were written for and tested on an Adex
  6830.   Corporation 8514/A using a Brooktree DAC.  The ATI GU 800x600x256 and
  6831.   1280x1024x16 modes require a ROM bios version of 1.3 or higher for
  6832.   800x600 and 1.4 or higher for 1280x1024.
  6833.  
  6834.   There are two sets of 8514/A modes: full sets (640x480, 800x600,
  6835.   1024x768, 1280x1024) which cover the entire screen and do NOT have a
  6836.   border color (so that you cannot tell when you are "paused" in a color-
  6837.   cycling mode), and partial sets (632x474, 792x594, 1016x762, 1272x1018)
  6838.   with small border areas which do turn white when you are paused in
  6839.   color-cycling mode. Also, while these modes are declared to be 256-
  6840.   color, if you do not have your 8514/A adapter loaded with its full
  6841.   complement of memory you will actually be in 16-color mode. The hardware
  6842.   register 16-color modes have not been tested.
  6843.  
  6844.   If your 8514/A adapter is not truly register compatible and Fractint
  6845.   does not detect this, use of the adapter interface can be forced by
  6846.   using afi=y or afi=8514 in your SSTOOLS.INI file.
  6847.  
  6848.   Finally, because IBM's adapter interface does not handle drawing single
  6849.   pixels very well (we have to draw a 1x1 pixel "box"), generating the
  6850.   zoom box when using the interface is excruciatingly slow. Still, it
  6851.   works!
  6852.  
  6853.   XGA MODES
  6854.  
  6855.   The XGA adapter is supported using the VESA/SuperVGA Autodetect modes -
  6856.   the XGA looks like just another SuperVGA adapter to Fractint.  The
  6857.   supported XGA modes are 640x480x256, 1024x768x16, 1024x768x256,
  6858.   800x600x16, and 800x600x256.  Note that the 1024x768x256 mode requires a
  6859.   full 1MB of adapter memory, the 1024x768 modes require a high-rez
  6860.   monitor, and the 800x600 modes require a multisynching monitor such as
  6861.   the NEC 2A.
  6862.  
  6863.   TARGA MODES
  6864.  
  6865.   TARGA support for Fractint is provided courtesy of Joe McLain and has
  6866.   been enhanced with the help of Bruce Goren and Richard Biddle.  To use a
  6867.   TARGA board with Fractint, you must define two DOS environment
  6868.   variables, "TARGA" and "TARGASET".  The definition of these variables is
  6869.   standardized by Truevision; if you have a TARGA board you probably
  6870.   already have added "SET" statements for these variables to your
  6871.   AUTOEXEC.BAT file.  Be aware that there are a LOT of possible TARGA
  6872.  
  6873.                       Fractint Version 19.2                       Page 125
  6874.  
  6875.   configurations, and a LOT of opportunities for a TARGA board and a VGA
  6876.   or EGA board to interfere with each other, and we may not have all of
  6877.   them smoothed away yet.  Also, the TARGA boards have an entirely
  6878.   different color-map scheme than the VGA cards, and at the moment they
  6879.   cannot be run through the color-cycling menu. The "MAP=" argument (see
  6880.   Color Parameters (p. 106)), however, works with both TARGA and VGA
  6881.   boards and enables you to redefine the default color maps with either
  6882.   board.
  6883.  
  6884.   TARGA+ MODES
  6885.  
  6886.   To use the special modes supported for TARGA+ adapters, the TARGAP.SYS
  6887.   device driver has to be loaded, and the TPLUS.DAT file (included with
  6888.   Fractint) must be in the same directory as Fractint.  The video modes
  6889.   with names containing "True Color Autodetect" can be used with the
  6890.   Targa+.  You might want to use the command line parameters "tplus=",
  6891.   "noninterlaced=", "maxcolorres=", and "pixelzoom=" (see Video Parameters
  6892.   (p. 111)) in your SSTOOLS.INI file to modify Fractint's use of the
  6893.   adapter.
  6894.  
  6895.  
  6896.  6.2 "Disk-Video" Modes
  6897.  
  6898.   These "video modes" do not involve a video adapter at all. They use (in
  6899.   order or preference) your expanded memory, your extended memory, or your
  6900.   disk drive (as file FRACTINT.$$$) to store the fractal image. These
  6901.   modes are useful for creating images beyond the capacity of your video
  6902.   adapter right up to the current internal limit of 2048 x 2048 x 256,
  6903.   e.g. for subsequent printing.  They're also useful for background
  6904.   processing under multi-tasking DOS managers - create an image in a disk-
  6905.   video mode, save it, then restore it in a real video mode.
  6906.  
  6907.   While you are using a disk-video mode, your screen will display text
  6908.   information indicating whether memory or your disk drive is being used,
  6909.   and what portion of the "screen" is being read from or written to.  A
  6910.   "Cache size" figure is also displayed. 64K is the maximum cache size.
  6911.   If you see a number less than this, it means that you don't have a lot
  6912.   of memory free, and that performance will be less than optimum.  With a
  6913.   very low cache size such as 4 or 6k, performance gets considerably worse
  6914.   in cases using solid guessing, boundary tracing, plasma, or anything
  6915.   else which paints the screen non-linearly.  If you have this problem,
  6916.   all we can suggest is having fewer TSR utilities loaded before starting
  6917.   Fractint, or changing in your config.sys file, such as reducing a very
  6918.   high BUFFERS value.
  6919.  
  6920.   The zoom box is disabled during disk-video modes (you couldn't see where
  6921.   it is anyway).  So is the orbit display feature.
  6922.  
  6923.   Color Cycling (p. 16) can be used during disk-video modes, but only to
  6924.   load or save a color palette.
  6925.  
  6926.   When using real disk for your disk-video, Fractint previously would not
  6927.   generate some "attractor" types (e.g. Lorenz) nor "IFS" images.  These
  6928.   stress disk drives with intensive reads and writes, but with the caching
  6929.   algorithm performance may be acceptable. Currently Fractint gives you a
  6930.   warning message but lets you proceed. You can end the calculation with
  6931.  
  6932.                       Fractint Version 19.2                       Page 126
  6933.  
  6934.   <Esc> if you think your hard disk is getting too strenuous a workout.
  6935.  
  6936.   When using a real disk, and you are not directing the file to a RAM
  6937.   disk, and you aren't using a disk caching program on your machine,
  6938.   specifying BUFFERS=10 (or more) in your config.sys file is best for
  6939.   performance.  BUFFERS=10,2 or even BUFFERS=10,4 is also good.  It is
  6940.   also best to keep your disk relatively "compressed" (or "defragmented")
  6941.   if you have a utility to do this.
  6942.  
  6943.   In order to use extended memory, you must have HIMEM.SYS or an
  6944.   equivalent that supports the XMS 2.0 standard or higher.  Also, you
  6945.   can't have a VDISK installed in extended memory.  Himem.sys is
  6946.   distributed with Microsoft Windows 286/386 and 3.0.  If you have
  6947.   problems using the extended memory, try rebooting with just himem.sys
  6948.   loaded and see if that clears up the problem.
  6949.  
  6950.   If you are running background disk-video fractals under Windows 3, and
  6951.   you don't have a lot of real memory (over 2Mb), you might find it best
  6952.   to force Fractint to use real disk for disk-video modes.  (Force this by
  6953.   using a .pif file with extended memory and expanded memory set to zero.)
  6954.   Try this if your disk goes crazy when generating background images,
  6955.   which are supposedly using extended or expanded memory.  This problem
  6956.   can occur because, to multi-task, sometimes Windows must page an
  6957.   application's expanded or extended memory to disk, in big chunks.
  6958.   Fractint's own cached disk access may be faster in such cases.
  6959.  
  6960.  
  6961.  6.3 Customized Video Modes, FRACTINT.CFG
  6962.  
  6963.   If you have a favorite adapter/video mode that you would like to add to
  6964.   Fractint... if you want some new sizes of disk-video modes... if you
  6965.   want to remove table entries that do not apply to your system... if you
  6966.   want to specify different "textsafe=" options for different video
  6967.   modes... relief is here, and without even learning "C"!
  6968.  
  6969.   You can do these things by modifying the FRACTINT.CFG file with your
  6970.   text editor. Saving a backup copy of FRACTINT.CFG first is of course
  6971.   highly recommended!
  6972.  
  6973.   Fractint uses a video adapter table for most of what it needs to know
  6974.   about any particular adapter/mode combination. The table is loaded from
  6975.   FRACTINT.CFG each time Fractint is run. It can contain information for
  6976.   up to 300 adapter/mode combinations. The table entries, and the function
  6977.   keys they are tied to, are displayed in the "select video mode" screen.
  6978.  
  6979.   This table makes adding support for various third-party video cards and
  6980.   their modes much easier, at least for the ones that pretend to be
  6981.   standard with extra dots and/or colors. There is even a special "roll-
  6982.   your-own" video mode (mode 19) enabling those of you with "C" compilers
  6983.   and a copy of the Fractint source to generate video modes supporting
  6984.   whatever adapter you may have.
  6985.  
  6986.   The table as currently distributed begins with nine standard and several
  6987.   non-standard IBM video modes that have been exercised successfully with
  6988.   a PS/2 model 80. These entries, coupled with the descriptive comments in
  6989.   the table definition and the information supplied (or that should have
  6990.  
  6991.                       Fractint Version 19.2                       Page 127
  6992.  
  6993.   been supplied!) with your video adapter, should be all you need to add
  6994.   your own entries.
  6995.  
  6996.   After the IBM and quasi-pseudo-demi-IBM modes, the table contains an
  6997.   ever-increasing number of entries for other adapters. Almost all of
  6998.   these entries have been added because someone like you sent us spec
  6999.   sheets, or modified Fractint to support them and then informed us about
  7000.   it.
  7001.  
  7002.   Lines in FRACTINT.CFG which begin with a semi-colon are treated as
  7003.   comments.  The rest of the lines must have eleven fields separated by
  7004.   commas.  The fields are defined as:
  7005.  
  7006.   1. Key assignment. F2 to F10, SF1 to SF10, CF1 to CF10, or AF1 to AF10.
  7007.      Blank if no key is assigned to the mode.
  7008.   2. The name of the adapter/video mode (25 chars max, no leading blanks).
  7009.      The adapter is set up for that mode via INT 10H, with:
  7010.   3. AX = this,
  7011.   4. BX = this,
  7012.   5. CX = this, and
  7013.   6. DX = this (hey, having all these registers wasn't OUR idea!)
  7014.   7. An encoded value describing how to write to your video memory in that
  7015.      mode. Currently available codes are:
  7016.     1) Use the BIOS (INT 10H, AH=12/13, AL=color) (last resort - SLOW!)
  7017.     2) Pretend it's a (perhaps super-res) EGA/VGA
  7018.     3) Pretend it's an MCGA
  7019.     4) SuperVGA 256-Color mode using the Tseng Labs chipset
  7020.     5) SuperVGA 256-Color mode using the Paradise chipset
  7021.     6) SuperVGA 256-Color mode using the Video-7 chipset
  7022.     7) Non-Standard IBM VGA 360 x 480 x 256-Color mode
  7023.     8) SuperVGA 1024x768x16 mode for the Everex chipset
  7024.     9) TARGA video modes
  7025.    10) HERCULES video mode
  7026.    11) Non-Video, i.e. "disk-video"
  7027.    12) 8514/A video modes
  7028.    13) CGA 320x200x4-color and 640x200x2-color modes
  7029.    14) Reserved for Tandy 1000 video modes
  7030.    15) SuperVGA 256-Color mode using the Trident chipset
  7031.    16) SuperVGA 256-Color mode using the Chips & Tech chipset
  7032.    17) SuperVGA 256-Color mode using the ATI VGA Wonder chipset
  7033.    18) SuperVGA 256-Color mode using the EVEREX chipset
  7034.    19) Roll-your-own video mode (as you've defined it in YOURVID.C)
  7035.    20) SuperVGA 1024x768x16 mode for the ATI VGA Wonder chipset
  7036.    21) SuperVGA 1024x768x16 mode for the Tseng Labs chipset
  7037.    22) SuperVGA 1024x768x16 mode for the Trident chipset
  7038.    23) SuperVGA 1024x768x16 mode for the Video 7 chipset
  7039.    24) SuperVGA 1024x768x16 mode for the Paradise chipset
  7040.    25) SuperVGA 1024x768x16 mode for the Chips & Tech chipset
  7041.    26) SuperVGA 1024x768x16 mode for the Everex Chipset
  7042.    27) SuperVGA Auto-Detect mode (we poke around looking for your adapter)
  7043.    28) VESA modes
  7044.    29) True Color Auto-Detect (currently only Targa+ supported)
  7045.   Add 100, 200, 300, or 400 to this code to specify an over-ride "textsafe="
  7046.    option to be used with the mode.  100=yes, 200=no, 300=bios, 400=save.
  7047.    E.g. 428 for a VESA mode with textsafe=save forced.
  7048.   8. The number of pixels across the screen (X - 160 to 2048)
  7049.  
  7050.                       Fractint Version 19.2                       Page 128
  7051.  
  7052.   9. The number of pixels down the screen (Y - 160 to 2048)
  7053.   10. The number of available colors (2, 4, 16, or 256)
  7054.   11. A comment describing the mode (25 chars max, leading blanks are OK)
  7055.  
  7056.   NOTE that the AX, BX, CX, and DX fields use hexadecimal notation
  7057.   (fifteen ==> 'f', sixteen ==> '10'), because that's the way most adapter
  7058.   documentation describes it. The other fields use standard decimal
  7059.   notation.
  7060.  
  7061.   If you look closely at the default entries, you will notice that the IBM
  7062.   VGA entries labeled "tweaked" and "non standard" have entries in the
  7063.   table with AX = BX = CX = 0, and DX = some other number. Those are
  7064.   special flags that we used to tell the program to custom-program the VGA
  7065.   adapter, and are NOT undocumented BIOS calls. Maybe they should be, but
  7066.   they aren't.
  7067.  
  7068.   If you have a fancy adapter and a new video mode that works on it, and
  7069.   it is not currently supported, PLEASE GET THAT INFORMATION TO US!  We
  7070.   will add the video mode to the list on our next release, and give you
  7071.   credit for it. Which brings up another point: If you can confirm that a
  7072.   particular video adapter/mode works (or that it doesn't), and the
  7073.   program says it is UNTESTED, please get that information to us also.
  7074.   Thanks in advance!
  7075.  
  7076.                       Fractint Version 19.2                       Page 129
  7077.  
  7078.  7. Common Problems
  7079.  
  7080.   Of course, Fractint would never stoop to having a "common" problem.
  7081.   These notes describe some, ahem, "special situations" which come up
  7082.   occasionally and which even we haven't the gall to label as "features".
  7083.  
  7084.   Hang during startup:
  7085.     There might be a problem with Fractint's video detection logic and
  7086.     your particular video adapter. Try running with "fractint adapter=xxx"
  7087.     where xxx is cga, ega, egamono, mcga, or vga.  If "adapter=vga" works,
  7088.     and you really have a SuperVGA adapter capable of higher video modes,
  7089.     there are other "adapter=" options for a number of SuperVGA chipsets -
  7090.     please see the full selection in Video Parameters (p. 111) for
  7091.     details.  If this solves the problem, create an SSTOOLS.INI file with
  7092.     the "adapter=xxx" command in it so that the fix will apply to every
  7093.     run.
  7094.     Another possible cause:  If you install the latest Fractint in say
  7095.     directory "newfrac", then run it from another directory with the
  7096.     command "\newfrac\fractint", *and* you have an older version of
  7097.     fractint.exe somewhere in your DOS PATH, a silent hang is all you'll
  7098.     get.  See the notes under the "Cannot find FRACTINT.EXE message"
  7099.     problem for the reason.
  7100.     Another possibility: try one of the "textsafe" parameter choices
  7101.     described in Video Parameters (p. 111).
  7102.  
  7103.   Scrambled image when returning from a text mode display:
  7104.     If an image which has been partly or completely generated gets partly
  7105.     destroyed when you return to it from the menu, help, or the
  7106.     information display, please try the various "textsafe" parameter
  7107.     options - see Video Parameters (p. 111) for details.  If this cures
  7108.     the problem, create an SSTOOLS.INI file with the "textsafe=xxx"
  7109.     command so that the fix will apply to every run.
  7110.  
  7111.   "Holes" in an image while it is being drawn:
  7112.     Little squares colored in your "inside" color, in a pattern of every
  7113.     second square of that size, in solid guessing mode, both across and
  7114.     down (i.e., 1 out of 4), are a symptom of an image which should be
  7115.     calculated with more conservative periodicity checking than the
  7116.     default.  See the Periodicity parameter under Image Calculation
  7117.     Parameters (p. 104).
  7118.  
  7119.   Black bar at top of screen during color cycling on 8086/8088 machines:
  7120.     (This might happen intermittently, not every run.)
  7121.     "fractint cyclelimit=10" might cure the problem.  If so, increase the
  7122.     cyclelimit value (try increasing by 5 or 10 each time) until the
  7123.     problem reappears, then back off one step and add that cyclelimit
  7124.     value to your SSTOOLS.INI file.
  7125.  
  7126.   Other video problems:
  7127.  
  7128.     If you are using a VESA driver with your video adapter, the first
  7129.     thing to try is the "vesadetect=no" parameter. If that fixes the
  7130.     problem, add it to your SSTOOLS.INI file to make the fix permanent.
  7131.  
  7132.                       Fractint Version 19.2                       Page 130
  7133.  
  7134.     It may help to explicitly specify your type of adapter - see the
  7135.     "adapter=" parameter in Video Parameters (p. 111).
  7136.  
  7137.     We've had one case where a video driver for Windows does not work
  7138.     properly with Fractint.  If running under Windows, DesqView, or some
  7139.     other layered environment, try running Fractint directly from DOS to
  7140.     see if that avoids the problem.
  7141.     We've also had one case of a problem co-existing with "386 to the
  7142.     Max".
  7143.  
  7144.     We've had one report of an EGA adapter which got scrambled images in
  7145.     all modes until "textsafe=no" was used (see Video Parameters (p. 111)
  7146.     ).
  7147.  
  7148.     Also, see Video Adapter Notes (p. 123) for information about enhanced
  7149.     video modes - Fractint makes only limited attempts to verify that a
  7150.     video mode you request is actually supported by your adapter.
  7151.  
  7152.   Other Hangs and Strange Behavior:
  7153.     We've had some problems (hangs and solid beeps) on an FPU equipped
  7154.     machine when running under Windows 3's enhanced mode.  The only ways
  7155.     around the problem we can find are to either run the Fractint image
  7156.     involved outside Windows, or to use the DOS command "SET NO87=nofpu"
  7157.     before running Fractint.  (This SET command makes Fractint ignore your
  7158.     fpu, so things might be a lot slower as a result.)
  7159.  
  7160.   Insufficient memory:
  7161.     Fractint requires a fair bit of memory to run.  Most machines with at
  7162.     least 640k (ok sticklers, make that "PC-compatible machines") will
  7163.     have no problem.  Machines with 512k and machines with many TSR
  7164.     utilities and/or a LAN interface may have problems.  Some Fractint
  7165.     features allocate memory when required during a run.  If you get a
  7166.     message about insufficient memory, or suspect that some problem is due
  7167.     to a memory shortage, you could try commenting out some TSR utilities
  7168.     in your AUTOEXEC.BAT file, some non-critical drivers in your
  7169.     CONFIG.SYS file, or reducing the BUFFERS parameter in your CONFIG.SYS.
  7170.  
  7171.   "Cannot find FRACTINT.EXE" message:
  7172.     Fractint is an overlayed program - some parts of it are brought from
  7173.     disk into memory only when used.  The overlay manager needs to know
  7174.     where to find the program.  It must be named FRACTINT.EXE (which it is
  7175.     unless somebody renamed it), and you should either be in the directory
  7176.     containing it when you start Fractint, or that directory should be in
  7177.     your DOS PATH.
  7178.  
  7179.   "File FRACTINT.CFG is missing or invalid" message:
  7180.     You should either start Fractint while you are in the directory
  7181.     containing it, or should have that directory in your DOS PATH
  7182.     variable.  If that isn't the problem, maybe you have a FRACTINT.CFG
  7183.     file from an older release of Fractint lying around? If so, best
  7184.     rename or delete it.  If that isn't the problem either, then the
  7185.     FRACTINT.CFG included in the FRAINT.EXE release file has probably been
  7186.     changed or deleted. Best reinstall Fractint to get a fresh copy.
  7187.  
  7188.                       Fractint Version 19.2                       Page 131
  7189.  
  7190.   Some other program doesn't like GIF files created by Fractint:
  7191.     Fractint generates nice clean GIF89A spec files, honest! But telling
  7192.     this to the other program isn't likely to change its mind. Instead,
  7193.     try an option which might get around the problem: run Fractint with
  7194.     the command line option "gif87a=yes" and then save an image. Fractint
  7195.     will store the image in the older GIF87A format, without any fractal
  7196.     parameters in it (so you won't be able to load the image back into
  7197.     Fractint and zoom into it - the fractal type, coordinates, etc. are
  7198.     not stored in this older format), and without an "aspect ratio" in the
  7199.     GIF header (we've seen one utility which doesn't like that field.)
  7200.  
  7201.   Disk video mode performance:
  7202.     This won't be blindingly fast at the best of times, but there are
  7203.     things which can slow it down and can be tuned.  See "Disk-Video"
  7204.     Modes (p. 125) for details.
  7205.  
  7206.                       Fractint Version 19.2                       Page 132
  7207.  
  7208.  8. Fractals and the PC
  7209.  
  7210.  
  7211.  8.1 A Little History
  7212.  
  7213.  
  7214.  8.1.1 Before Mandelbrot
  7215.  
  7216.   Like new forms of life, new branches of mathematics and science don't
  7217.   appear from nowhere. The ideas of fractal geometry can be traced to the
  7218.   late nineteenth century, when mathematicians created shapes -- sets of
  7219.   points -- that seemed to have no counterpart in nature.  By a wonderful
  7220.   irony, the "abstract" mathematics descended from that work has now
  7221.   turned out to be MORE appropriate than any other for describing many
  7222.   natural shapes and processes.
  7223.  
  7224.   Perhaps we shouldn't be surprised.  The Greek geometers worked out the
  7225.   mathematics of the conic sections for its formal beauty; it was two
  7226.   thousand years before Copernicus and Brahe, Kepler and Newton overcame
  7227.   the preconception that all heavenly motions must be circular, and found
  7228.   the ellipse, parabola, and hyperbola in the paths of planets, comets,
  7229.   and projectiles.
  7230.  
  7231.   In the 17th century Newton and Leibniz created calculus, with its
  7232.   techniques for "differentiating" or finding the derivative of functions
  7233.   -- in geometric terms, finding the tangent of a curve at any given
  7234.   point.  True, some functions were discontinuous, with no tangent at a
  7235.   gap or an isolated point. Some had singularities: abrupt changes in
  7236.   direction at which the idea of a tangent becomes meaningless. But these
  7237.   were seen as exceptional, and attention was focused on the "well-
  7238.   behaved" functions that worked well in modeling nature.
  7239.  
  7240.   Beginning in the early 1870s, though, a 50-year crisis transformed
  7241.   mathematical thinking. Weierstrass described a function that was
  7242.   continuous but nondifferentiable -- no tangent could be described at any
  7243.   point. Cantor showed how a simple, repeated procedure could turn a line
  7244.   into a dust of scattered points, and Peano generated a convoluted curve
  7245.   that eventually touches every point on a plane. These shapes seemed to
  7246.   fall "between" the usual categories of one-dimensional lines, two-
  7247.   dimensional planes and three-dimensional volumes. Most still saw them as
  7248.   "pathological" cases, but here and there they began to find
  7249.   applications.
  7250.  
  7251.   In other areas of mathematics, too, strange shapes began to crop up.
  7252.   Poincare attempted to analyze the stability of the solar system in the
  7253.   1880s and found that the many-body dynamical problem resisted
  7254.   traditional methods. Instead, he developed a qualitative approach, a
  7255.   "state space" in which each point represented a different planetary
  7256.   orbit, and studied what we would now call the topology -- the
  7257.   "connectedness" -- of whole families of orbits. This approach revealed
  7258.   that while many initial motions quickly settled into the familiar
  7259.   curves, there were also strange, "chaotic" orbits that never became
  7260.   periodic and predictable.
  7261.  
  7262.                       Fractint Version 19.2                       Page 133
  7263.  
  7264.   Other investigators trying to understand fluctuating, "noisy" phenomena
  7265.   -- the flooding of the Nile, price series in economics, the jiggling of
  7266.   molecules in Brownian motion in fluids -- found that traditional models
  7267.   could not match the data. They had to introduce apparently arbitrary
  7268.   scaling features, with spikes in the data becoming rarer as they grew
  7269.   larger, but never disappearing entirely.
  7270.  
  7271.   For many years these developments seemed unrelated, but there were
  7272.   tantalizing hints of a common thread. Like the pure mathematicians'
  7273.   curves and the chaotic orbital motions, the graphs of irregular time
  7274.   series often had the property of self-similarity: a magnified small
  7275.   section looked very similar to a large one over a wide range of scales.
  7276.  
  7277.  
  7278.  8.1.2 Who Is This Guy, Anyway?
  7279.  
  7280.   While many pure and applied mathematicians advanced these trends, it is
  7281.   Benoit Mandelbrot above all who saw what they had in common and pulled
  7282.   the threads together into the new discipline.
  7283.  
  7284.   He was born in Warsaw in 1924, and moved to France in 1935. In a time
  7285.   when French mathematical training was strongly analytic, he visualized
  7286.   problems whenever possible, so that he could attack them in geometric
  7287.   terms.  He attended the Ecole Polytechnique, then Caltech, where he
  7288.   encountered the tangled motions of fluid turbulence.
  7289.  
  7290.   In 1958 he joined IBM, where he began a mathematical analysis of
  7291.   electronic "noise" -- and began to perceive a structure in it, a
  7292.   hierarchy of fluctuations of all sizes, that could not be explained by
  7293.   existing statistical methods. Through the years that followed, one
  7294.   seemingly unrelated problem after another was drawn into the growing
  7295.   body of ideas he would come to call fractal geometry.
  7296.  
  7297.   As computers gained more graphic capabilities, the skills of his mind's
  7298.   eye were reinforced by visualization on display screens and plotters.
  7299.   Again and again, fractal models produced results -- series of flood
  7300.   heights, or cotton prices -- that experts said looked like "the real
  7301.   thing."
  7302.  
  7303.   Visualization was extended to the physical world as well. In a
  7304.   provocative essay titled "How Long Is the Coast of Britain?" Mandelbrot
  7305.   noted that the answer depends on the scale at which one measures: it
  7306.   grows longer and longer as one takes into account every bay and inlet,
  7307.   every stone, every grain of sand. And he codified the "self-similarity"
  7308.   characteristic of many fractal shapes -- the reappearance of
  7309.   geometrically similar features at all scales.
  7310.  
  7311.   First in isolated papers and lectures, then in two editions of his
  7312.   seminal book, he argued that many of science's traditional mathematical
  7313.   models are ill-suited to natural forms and processes: in fact, that many
  7314.   of the "pathological" shapes mathematicians had discovered generations
  7315.   before are useful approximations of tree bark and lung tissue, clouds
  7316.   and galaxies.
  7317.  
  7318.                       Fractint Version 19.2                       Page 134
  7319.  
  7320.   Mandelbrot was named an IBM Fellow in 1974, and continues to work at the
  7321.   IBM Watson Research Center. He has also been a visiting professor and
  7322.   guest lecturer at many universities.
  7323.  
  7324.  
  7325.  8.2 A Little Code
  7326.  
  7327.  
  7328.  8.2.1 Periodicity Logic
  7329.  
  7330.   The "Mandelbrot Lake" in the center of the M-set images is the
  7331.   traditional bane of plotting programs. It sucks up the most computer
  7332.   time because it always reaches the iteration limit -- and yet the most
  7333.   interesting areas are invariably right at the edge the lake.  (See The
  7334.   Mandelbrot Set (p. 33) for a description of the iteration process.)
  7335.  
  7336.   Thanks to Mark Peterson for pointing out (well, he more like beat us
  7337.   over the head until we paid attention) that the iteration values in the
  7338.   middle of Mandelbrot Lake tend to decay to periodic loops (i.e., Z(n+m)
  7339.   == Z(n), a fact that is pointed out on pages 58-61 of "The Beauty of
  7340.   Fractals"). An intelligent program (like the one he wrote) would check
  7341.   for this periodicity once in a while, recognize that iterations caught
  7342.   in a loop are going to max out, and bail out early.
  7343.  
  7344.   For speed purposes, the current version of the program turns this
  7345.   checking algorithm on only if the last pixel generated was in the lake.
  7346.   (The checking itself takes a small amount of time, and the pixels on the
  7347.   very edge of the lake tend to decay to periodic loops very slowly, so
  7348.   this compromise turned out to be the fastest generic answer).
  7349.  
  7350.   Try a full M-set plot with a 1000-iteration maximum with any other
  7351.   program, and then try it on this one for a pretty dramatic proof of the
  7352.   value of periodicity checking.
  7353.  
  7354.   You can get a visual display of the periodicity effects if you press
  7355.   <O>rbits while plotting. This toggles display of the intermediate
  7356.   iterations during the generation process.  It also gives you an idea of
  7357.   how much work your poor little PC is going through for you!  If you use
  7358.   this toggle, it's best to disable solid-guessing first using <1> or <2>
  7359.   because in its second pass, solid-guessing bypasses many of the pixel
  7360.   calculations precisely where the orbits are most interesting.
  7361.  
  7362.   Mark was also responsible for pointing out that 16-bit integer math was
  7363.   good enough for the first few levels of M/J images, where the round-off
  7364.   errors stay well within the area covered by a single pixel. Fractint now
  7365.   uses 16-bit math where applicable, which makes a big difference on non-
  7366.   32-bit PCs.
  7367.  
  7368.  
  7369.  8.2.2 Limitations of Integer Math (And How We Cope)
  7370.  
  7371.   By default, Fractint uses 16-bit and/or 32-bit integer math to generate
  7372.   nearly all its fractal types. The advantage of integer math is speed:
  7373.   this is by far the fastest such plotter that we have ever seen on any
  7374.   PC. The disadvantage is an accuracy limit. Integer math represents
  7375.   numbers like 1.00 as 32-bit integers of the form [1.00 * (2^29)]
  7376.  
  7377.                       Fractint Version 19.2                       Page 135
  7378.  
  7379.   (approximately a range of 500,000,000) for the Mandelbrot and Julia
  7380.   sets. Other integer fractal types use a bitshift of 24 rather than 29,
  7381.   so 1.0 is stored internally as [1.00 * (2^24)]. This yields accuracy of
  7382.   better than 8 significant digits, and works fine... until the initial
  7383.   values of the calculations on consecutive pixels differ only in the
  7384.   ninth decimal place.
  7385.  
  7386.   At that point, if Fractint has a floating-point algorithm handy for that
  7387.   particular fractal type (and virtually all of the fractal types have one
  7388.   these days), it will silently switch over to the floating-point
  7389.   algorithm and keep right on going.  Fair warning - if you don't have an
  7390.   FPU, the effect is that of a rocket sled hitting a wall of jello, and
  7391.   even if you do, the slowdown is noticeable.
  7392.  
  7393.   If it has no floating-point algorithm, Fractint does the best it can: it
  7394.   switches to its minimal drawing mode, with adjacent pixels having
  7395.   initial values differing by 1 (really 0.000000002).  Attempts to zoom
  7396.   further may result in moving the image around a bit, but won't actually
  7397.   zoom.  If you are stuck with an integer algorithm, you can reach minimal
  7398.   mode with your fifth consecutive "maximum zoom", each of which covers
  7399.   about 0.25% of the previous screen. By then your full-screen image is an
  7400.   area less than 1/(10^13)th [~0.0000000000001] the area of the initial
  7401.   screen.  (If your image is rotated or stretched very slightly, you can
  7402.   run into the wall of jello as early as the fourth consecutive maximum
  7403.   zoom.  Rotating or stretching by larger amounts has less impact on how
  7404.   soon you run into it.)
  7405.  
  7406.   Think of it this way: at minimal drawing mode, your VGA display would
  7407.   have to have a surface area of over one million square miles just to be
  7408.   able to display the entire M-set using the integer algorithms.  Using
  7409.   the floating-point algorithms, your display would have to be big enough
  7410.   to fit the entire solar system out to the orbit of Saturn inside it.  So
  7411.   there's a considerable saving on hardware, electricity and desk space
  7412.   involved here.  Also, you don't have to take out asteroid insurance.
  7413.  
  7414.   32 bit integers also limit the largest number which can be stored.  This
  7415.   doesn't matter much since numbers outside the supported range (which is
  7416.   between -4 and +4) produce a boring single color. If you try to zoom-out
  7417.   to reduce the entire Mandelbrot set to a speck, or to squeeze it to a
  7418.   pancake, you'll find you can't do so in integer math mode.
  7419.  
  7420.  
  7421.  8.2.3 Arbitrary Precision and Deep Zooming
  7422.  
  7423.   The zoom limit of Fractint is approximately 10^15 (10 to the fifteenth
  7424.   power). This limit is due to the precision possible with the computer
  7425.   representation of numbers as 64 bit double precision data. To give you
  7426.   an idea of just how big a magnification 10^15 is, consider this. At the
  7427.   scale of your computer screen while displaying a tiny part of the
  7428.   Mandelbrot set at the deepest possible zoom, the entire Mandelbrot set
  7429.   would be many millions of miles wide, as big as the orbit of Jupiter.
  7430.  
  7431.   Big as this zoom magnification is, your PC can do better using something
  7432.   called arbitrary precision math. Instead of using 64 bit double
  7433.   precision to represent numbers, your computer software allocates as much
  7434.   memory as needed to create a data type supporting as many decimals of
  7435.  
  7436.                       Fractint Version 19.2                       Page 136
  7437.  
  7438.   precision as you want.
  7439.  
  7440.   Incorporation of this feature in Fractint was inspired by Jay Hill and
  7441.   his DEEPZOOM program which uses the shareware MFLOAT programming
  7442.   library.  Several of the Stone Soup programmers noticed Jay's posts in
  7443.   the Internet sci.fractals newsgroup and began to investigate adding
  7444.   arbitrary precision to Fractint. High school math and physics teacher
  7445.   Wes Loewer wrote an arbitrary precision library in both 80x86 assembler
  7446.   and C, and the Stone Soup team incorporated Wes's library into Fractint.
  7447.   Initially, support was added for fractal types mandel, julia, manzpower,
  7448.   and julzpower.
  7449.  
  7450.   Normally, when you reach Fractint's zoom limit, Fractint simply refuses
  7451.   to let you zoom any more. When using the fractal types that support
  7452.   arbitrary precision, you will not reach this limit, but can keep on
  7453.   zooming. When you pass the threshold between double precision and
  7454.   arbitrary precision, Fractint will dramatically slow down. The <tab>
  7455.   status screen can be used to verify that Fractint is indeed using
  7456.   arbitrary precision.
  7457.  
  7458.   Fractals with arbitrary precision are SLOW, as much as ten times slower
  7459.   than if the math were done with your math coprocessor, and even slower
  7460.   simply because the zoom depth is greater. The good news, if you want to
  7461.   call it that, is that your math coprocessor is not needed;
  7462.   coprocessorless machines can produce deep zooms with the same glacial
  7463.   slowness as machines with coprocessors!
  7464.  
  7465.   Maybe the real point of arbitrary precision math is to prolong the
  7466.   "olden" days when men were men, women were women, and real fractal
  7467.   programmers spent weeks generating fractals. One of your Stone Soup
  7468.   authors has a large monitor that blinks a bit when changing video modes-
  7469.   -PCs have gotten so fast that Fractint finishes the default 320x200
  7470.   Mandelbrot before the monitor can even complete its blinking transition
  7471.   to graphics mode! Computers are getting faster every day, and soon a new
  7472.   generation of fractal lovers might forget that fractal generation is
  7473.   *supposed* to be slow, just as it was in Grandpa's day when they only
  7474.   had Pentium chips. The solution to this educational dilemma is
  7475.   Fractint's arbitrary precision feature. Even the newest sexium and
  7476.   septium machines are going to have to chug for days or weeks at the
  7477.   extreme zoom depths now possible ...
  7478.  
  7479.   So how far can you zoom? How does 10^1600 sound--roughly 1600 decimal
  7480.   digits of precision. To put *this* magnification in perspective, the
  7481.   "tiny" ratio of 10^61 is the ratio of the entire visible universe to the
  7482.   smallest quantum effects. With 1600 digits to work with, you can expand
  7483.   an electron-sized image up to the size of the visible universe, not once
  7484.   but more than twenty times. So you can examine screen-sized portions of
  7485.   a Mandelbrot set so large all but a tiny part of it would be vastly
  7486.   farther away than the billion or so light year limit of our best
  7487.   telescopes.
  7488.  
  7489.   Lest anyone suppose that we Stone Soupers suffer from an inflated pride
  7490.   over having thus spanned the Universe, current inflationary cosmological
  7491.   theories estimate the size of the universe to be unimaginably larger
  7492.   than the "tiny" part we can see.
  7493.  
  7494.                       Fractint Version 19.2                       Page 137
  7495.  
  7496.   Note: many of Fractint's options do not work with arbitrary precision.
  7497.   To experiment with arbitrary precision at the speedier ordinary
  7498.   magnifications, start Fractint with the debug=3200 command-line option.
  7499.   With the exception of mandel and manzpower perturbations, values that
  7500.   would normally be entered in the Parameters and Coordinates screens need
  7501.   to be entered using the command-line interface or .par files.  Other
  7502.   known things that do not yet work with arbitrary precision are:
  7503.   biomorph, decomp, distance estimator, inversion, Julia-Mandel switch,
  7504.   history, orbit-in-window, and the browse feature.
  7505.  
  7506.  
  7507.  8.2.4 The Fractint "Fractal Engine" Architecture
  7508.  
  7509.   Several of the authors would never ADMIT this, but Fractint has evolved
  7510.   a powerful and flexible architecture that makes adding new fractals very
  7511.   easy. (They would never admit this because they pride themselves on
  7512.   being the sort that mindlessly but happily hacks away at code and "sees
  7513.   if it works and doesn't hang the machine".)
  7514.  
  7515.   Many fractal calculations work by taking a rectangle in the complex
  7516.   plane, and, point by point, calculating a color corresponding to that
  7517.   point.  Furthermore, the color calculation is often done by iterating a
  7518.   function over and over until some bailout condition is met.  (See The
  7519.   Mandelbrot Set (p. 33) for a description of the iteration process.)
  7520.  
  7521.   In implementing such a scheme, there are three fractal-specific
  7522.   calculations that take place within a framework that is pretty much the
  7523.   same for them all.  Rather than copy the same code over and over, we
  7524.   created a standard fractal engine that calls three functions that may be
  7525.   bolted in temporarily to the engine.  The "bolting in" process uses the
  7526.   C language mechanism of variable function pointers.
  7527.  
  7528.   These three functions are:
  7529.  
  7530.      1) a setup function that is run once per image, to do any required
  7531.      initialization of variables,
  7532.  
  7533.      2) a once-per-pixel function that does whatever initialization has to
  7534.      be done to calculate a color for one pixel, and
  7535.  
  7536.      3) a once-per-orbit-iteration function, which is the fundamental
  7537.      fractal algorithm that is repeatedly iterated in the fractal
  7538.      calculation.
  7539.  
  7540.   The common framework that calls these functions can contain all sorts of
  7541.   speedups, tricks, and options that the fractal implementor need not
  7542.   worry about.  All that is necessary is to write the three functions in
  7543.   the correct way, and BINGO! - all options automatically apply. What
  7544.   makes it even easier is that usually one can re-use functions 1) and 2)
  7545.   written for other fractals, and therefore only need to write function
  7546.   3).
  7547.  
  7548.   Then it occurred to us that there might be more than one sort of fractal
  7549.   engine, so we even allowed THAT to be bolted in. And we created a data
  7550.   structure for each fractal that includes pointers to these four
  7551.   functions, various prompts, a default region of the complex plane, and
  7552.  
  7553.                       Fractint Version 19.2                       Page 138
  7554.  
  7555.   various miscellaneous bits of information that allow toggling between
  7556.   Julia and Mandelbrot or toggling between the various kinds of math used
  7557.   in implementation.
  7558.  
  7559.   That sounds pretty flexible, but there is one drawback - you have to be
  7560.   a C programmer and have a C compiler to make use of it! So we took it a
  7561.   step further, and designed a built-in high level compiler, so that you
  7562.   can enter the formulas for the various functions in a formula file in a
  7563.   straightforward algebra-like language, and Fractint will compile them
  7564.   and bolt them in for you!
  7565.  
  7566.   There is a terrible down side to this flexibility.  Fractint users
  7567.   everywhere are going berserk. Fractal-inventing creativity is running
  7568.   rampant. Proposals for new fractal types are clogging the mail and the
  7569.   telephones.
  7570.  
  7571.   All we can say is that non-productivity software has never been so
  7572.   potent, and we're sorry, it's our fault!
  7573.  
  7574.   Fractint was compiled using Microsoft C 7.0 and Microsoft Assembler 6.0,
  7575.   using the "Medium" model. Note that the assembler code uses the "C"
  7576.   model option added to version 5.1, and must be assembled with the /MX or
  7577.   /ML switch to link with the "C" code. Because it has become too large to
  7578.   distribute comfortably as a single compressed file, and because many
  7579.   downloaders have no intention of ever modifying it, Fractint is now
  7580.   distributed as two files: one containing FRACTINT.EXE, auxiliary files
  7581.   and this document, and another containing complete source code
  7582.   (including a .MAK file and MAKEFRAC.BAT).  See Distribution of Fractint
  7583.   (p. 160).
  7584.  
  7585.                       Fractint Version 19.2                       Page 139
  7586.  
  7587.  Appendix A Mathematics of the Fractal Types
  7588.  
  7589.   SUMMARY OF FRACTAL TYPES
  7590.  
  7591.   ant (p. 67)
  7592.       Generalized Ant Automaton as described in the July 1994 Scientific
  7593.       American. Some ants wander around the screen. A rule string (the first
  7594.       parameter) determines the ant's direction. When the type 1 ant leaves a
  7595.       cell of color k, it turns right if the kth symbol in the first parameter
  7596.       is a 1, or left otherwise. Then the color in the old cell is incremented.
  7597.       The 2nd parameter is a maximum iteration to guarantee that the fractal
  7598.       will terminate. The 3rd parameter is the number of ants. The 4th is the
  7599.       ant type 1 or 2. The 5th parameter determines if the ants wrap the screen
  7600.       or stop at the edge.  The 6th parameter is a random seed. You can slow
  7601.       down the ants to see them better using the <x> screen Orbit Delay.
  7602.   barnsleyj1 (p. 42)
  7603.         z(0) = pixel;
  7604.         z(n+1) = (z-1)*c if real(z) >= 0, else
  7605.         z(n+1) = (z+1)*c
  7606.       Two parameters: real and imaginary parts of c
  7607.   barnsleyj2 (p. 42)
  7608.         z(0) = pixel;
  7609.         if real(z(n)) * imag(c) + real(c) * imag(z((n)) >= 0
  7610.            z(n+1) = (z(n)-1)*c
  7611.         else
  7612.            z(n+1) = (z(n)+1)*c
  7613.       Two parameters: real and imaginary parts of c
  7614.   barnsleyj3 (p. 42)
  7615.         z(0) = pixel;
  7616.         if real(z(n) > 0 then z(n+1) = (real(z(n))^2 - imag(z(n))^2 - 1)
  7617.            + i * (2*real(z((n)) * imag(z((n))) else
  7618.         z(n+1) = (real(z(n))^2 - imag(z(n))^2 - 1 + real(c) * real(z(n))
  7619.                + i * (2*real(z((n)) * imag(z((n)) + imag(c) * real(z(n))
  7620.       Two parameters: real and imaginary parts of c.
  7621.   barnsleym1 (p. 42)
  7622.         z(0) = c = pixel;
  7623.         if real(z) >= 0 then
  7624.           z(n+1) = (z-1)*c
  7625.         else
  7626.           z(n+1) = (z+1)*c.
  7627.       Parameters are perturbations of z(0)
  7628.   barnsleym2 (p. 42)
  7629.         z(0) = c = pixel;
  7630.         if real(z)*imag(c) + real(c)*imag(z) >= 0
  7631.           z(n+1) = (z-1)*c
  7632.         else
  7633.           z(n+1) = (z+1)*c
  7634.       Parameters are perturbations of z(0)
  7635.  
  7636.   barnsleym3 (p. 42)
  7637.         z(0) = c = pixel;
  7638.         if real(z(n) > 0 then z(n+1) = (real(z(n))^2 - imag(z(n))^2 - 1)
  7639.            + i * (2*real(z((n)) * imag(z((n))) else
  7640.         z(n+1) = (real(z(n))^2 - imag(z(n))^2 - 1 + real(c) * real(z(n))
  7641.            + i * (2*real(z((n)) * imag(z((n)) + imag(c) * real(z(n))
  7642.       Parameters are perturbations of z(0)
  7643.  
  7644.                       Fractint Version 19.2                       Page 140
  7645.  
  7646.   bifurcation (p. 48)
  7647.       Pictorial representation of a population growth model.
  7648.         Let P = new population, p = oldpopulation, r = growth rate
  7649.         The model is: P = p + r*fn(p)*(1-fn(p)).
  7650.       Three parameters: Filter Cycles, Seed Population, and Function.
  7651.  
  7652.   bif+sinpi (p. 48)
  7653.       Bifurcation variation: model is: P = p + r*fn(PI*p).
  7654.       Three parameters: Filter Cycles, Seed Population, and Function.
  7655.  
  7656.   bif=sinpi (p. 48)
  7657.       Bifurcation variation: model is: P = r*fn(PI*p).
  7658.       Three parameters: Filter Cycles, Seed Population, and Function.
  7659.  
  7660.   biflambda (p. 48)
  7661.       Bifurcation variation: model is: P = r*fn(p)*(1-fn(p)).
  7662.       Three parameters: Filter Cycles, Seed Population, and Function.
  7663.  
  7664.   bifstewart (p. 48)
  7665.       Bifurcation variation: model is: P = (r*fn(p)*fn(p)) - 1.
  7666.       Three parameters: Filter Cycles, Seed Population, and Function.
  7667.  
  7668.   bifmay (p. 48)
  7669.       Bifurcation variation: model is: P = r*p / ((1+p)^beta).
  7670.       Three parameters: Filter Cycles, Seed Population, and Beta.
  7671.  
  7672.   cellular (p. 66)
  7673.       One-dimensional cellular automata or line automata.  The type of CA
  7674.       is given by kr, where k is the number of different states of the
  7675.       automata and r is the radius of the neighborhood.  The next generation
  7676.       is determined by the sum of the neighborhood and the specified rule.
  7677.       Four parameters: Initial String, Rule, Type, and Starting Row Number.
  7678.       For Type = 21, 31, 41, 51, 61, 22, 32, 42, 23, 33, 24, 25, 26, 27
  7679.           Rule =  4,  7, 10, 13, 16,  6, 11, 16,  8, 15, 10, 12, 14, 16 digits
  7680.   chip (p. 53)
  7681.       Chip attractor from Michael Peters - orbit in two dimensions.
  7682.         z(0) = y(0) = 0;
  7683.         x(n+1) = y(n) - sign(x(n)) * cos(sqr(ln(abs(b*x(n)-c))))
  7684.                                    * arctan(sqr(ln(abs(c*x(n)-b))))
  7685.         y(n+1) = a - x(n)
  7686.       Parameters are a, b, and c.
  7687.   circle (p. 40)
  7688.       Circle pattern by John Connett
  7689.         x + iy = pixel
  7690.         z = a*(x^2 + y^2)
  7691.         c = integer part of z
  7692.         color = c modulo(number of colors)
  7693.   cmplxmarksjul (p. 46)
  7694.       A generalization of the marksjulia fractal.
  7695.         z(0) = pixel;
  7696.         z(n+1) = (c^exp-1)*z(n)^2 + c.
  7697.       Four parameters: real and imaginary parts of c,
  7698.       and real and imaginary parts of exponent.
  7699.   cmplxmarksmand (p. 46)
  7700.       A generalization of the marksmandel fractal.
  7701.         z(0) = c = pixel;
  7702.  
  7703.                       Fractint Version 19.2                       Page 141
  7704.  
  7705.         z(n+1) = (c^exp-1)*z(n)^2 + c.
  7706.       Four parameters: real and imaginary parts of perturbation
  7707.       of z(0), and real and imaginary parts of exponent.
  7708.  
  7709.   complexnewton, complexbasin (p. 38)
  7710.       Newton fractal types extended to complex degrees. Complexnewton
  7711.       colors pixels according to the number of iterations required to
  7712.       escape to a root. Complexbasin colors pixels according to which
  7713.       root captures the orbit. The equation is based on the newton
  7714.       formula for solving the equation z^p = r
  7715.         z(0) = pixel;
  7716.         z(n+1) = ((p - 1) * z(n)^p + r)/(p * z(n)^(p - 1)).
  7717.       Four parameters: real & imaginary parts of degree p and root r.
  7718.  
  7719.   diffusion (p. 58)
  7720.       Diffusion Limited Aggregation.  Randomly moving points
  7721.       accumulate.  Two parameters: border width (default 10), type.
  7722.  
  7723.   dynamic (p. 64)
  7724.       Time-discrete dynamic system.
  7725.         x(0) = y(0) = start position.
  7726.         y(n+1) = y(n) + f( x(n) )
  7727.         x(n+1) = x(n) - f( y(n) )
  7728.         f(k) = sin(k + a*fn1(b*k))
  7729.       For implicit Euler approximation: x(n+1) = x(n) - f( y(n+1) )
  7730.       Five parameters: start position step, dt, a, b, and the function fn1.
  7731.  
  7732.   fn(z)+fn(pix) (p. 47)
  7733.         c = z(0) = pixel;
  7734.         z(n+1) = fn1(z) + p*fn2(c)
  7735.       Six parameters: real and imaginary parts of the perturbation
  7736.       of z(0) and factor p, and the functions fn1, and fn2.
  7737.   fn(z*z) (p. 47)
  7738.         z(0) = pixel;
  7739.         z(n+1) = fn(z(n)*z(n))
  7740.       One parameter: the function fn.
  7741.  
  7742.   fn*fn (p. 47)
  7743.         z(0) = pixel; z(n+1) = fn1(n)*fn2(n)
  7744.       Two parameters: the functions fn1 and fn2.
  7745.  
  7746.   fn*z+z (p. 47)
  7747.         z(0) = pixel; z(n+1) = p1*fn(z(n))*z(n) + p2*z(n)
  7748.       Five parameters: the real and imaginary components of
  7749.       p1 and p2, and the function fn.
  7750.  
  7751.   fn+fn (p. 47)
  7752.         z(0) = pixel;
  7753.         z(n+1) = p1*fn1(z(n))+p2*fn2(z(n))
  7754.       Six parameters: The real and imaginary components of
  7755.       p1 and p2, and the functions fn1 and fn2.
  7756.  
  7757.   formula (p. 55)
  7758.       Formula interpreter - write your own formulas as text files!
  7759.  
  7760.                       Fractint Version 19.2                       Page 142
  7761.  
  7762.   frothybasin (p. 69)
  7763.       Pixel color is determined by which attractor captures the orbit.  The
  7764.       shade of color is determined by the number of iterations required to
  7765.       capture the orbit.
  7766.         Z(0) = pixel;  Z(n+1) = Z(n)^2 - C*conj(Z(n))
  7767.         where C = 1 + A*i, critical value of A = 1.028713768218725...
  7768.  
  7769.   gingerbread (p. 53)
  7770.       Orbit in two dimensions defined by:
  7771.         x(n+1) = 1 - y(n) + |x(n)|
  7772.         y(n+1) = x(n)
  7773.       Two parameters: initial values of x(0) and y(0).
  7774.  
  7775.   halley (p. 63)
  7776.         Halley map for the function: F = z(z^a - 1) = 0
  7777.         z(0) = pixel;
  7778.         z(n+1) = z(n) - R * F / [F' - (F" * F / 2 * F')]
  7779.         bailout when: abs(mod(z(n+1)) - mod(z(n)) < epsilon
  7780.       Four parameters: order a, real part of R, epsilon,
  7781.          and imaginary part of R.
  7782.   henon (p. 52)
  7783.       Orbit in two dimensions defined by:
  7784.         x(n+1) = 1 + y(n) - a*x(n)*x(n)
  7785.         y(n+1) = b*x(n)
  7786.       Two parameters: a and b
  7787.  
  7788.   hopalong (p. 53)
  7789.       Hopalong attractor by Barry Martin - orbit in two dimensions.
  7790.         z(0) = y(0) = 0;
  7791.         x(n+1) = y(n) - sign(x(n))*sqrt(abs(b*x(n)-c))
  7792.         y(n+1) = a - x(n)
  7793.       Parameters are a, b, and c.
  7794.  
  7795.   hypercomplex (p. 66)
  7796.       HyperComplex Mandelbrot set.
  7797.         h(0)   = (0,0,0,0)
  7798.         h(n+1) = fn(h(n)) + C.
  7799.         where "fn" is sin, cos, log, sqr etc.
  7800.       Two parameters: cj, ck
  7801.       C = (xpixel,ypixel,cj,ck)
  7802.  
  7803.   hypercomplexj (p. 66)
  7804.       HyperComplex Julia set.
  7805.         h(0)   = (xpixel,ypixel,zj,zk)
  7806.         h(n+1) = fn(h(n)) + C.
  7807.         where "fn" is sin, cos, log, sqr etc.
  7808.       Six parameters: c1, ci, cj, ck
  7809.       C = (c1,ci,cj,ck)
  7810.  
  7811.   icon, icon3d (p. 54)
  7812.       Orbit in three dimensions defined by:
  7813.         p = lambda + alpha * magnitude + beta * (x(n)*zreal - y(n)*zimag)
  7814.         x(n+1) = p * x(n) + gamma * zreal - omega * y(n)
  7815.         y(n+1) = p * y(n) - gamma * zimag + omega * x(n)
  7816.         (3D version uses magnitude for z)
  7817.         Parameters:  Lambda, Alpha, Beta, Gamma, Omega, and Degree
  7818.  
  7819.                       Fractint Version 19.2                       Page 143
  7820.  
  7821.   IFS (p. 43)
  7822.       Barnsley IFS (Iterated Function System) fractals. Apply
  7823.       contractive affine mappings.
  7824.  
  7825.   julfn+exp (p. 45)
  7826.       A generalized Clifford Pickover fractal.
  7827.         z(0) = pixel;
  7828.         z(n+1) = fn(z(n)) + e^z(n) + c.
  7829.       Three parameters: real & imaginary parts of c, and fn
  7830.  
  7831.   julfn+zsqrd (p. 45)
  7832.         z(0) = pixel;
  7833.         z(n+1) = fn(z(n)) + z(n)^2 + c
  7834.       Three parameters: real & imaginary parts of c, and fn
  7835.  
  7836.   julia (p. 34)
  7837.       Classic Julia set fractal.
  7838.         z(0) = pixel; z(n+1) = z(n)^2 + c.
  7839.       Two parameters: real and imaginary parts of c.
  7840.  
  7841.   julia_inverse (p. 36)
  7842.       Inverse Julia function - "orbit" traces Julia set in two dimensions.
  7843.         z(0) = a point on the Julia Set boundary; z(n+1) = +- sqrt(z(n) - c)
  7844.       Parameters: Real and Imaginary parts of c
  7845.              Maximum Hits per Pixel (similar to max iters)
  7846.              Breadth First, Depth First or Random Walk Tree Traversal
  7847.              Left or Right First Branching (in Depth First mode only)
  7848.           Try each traversal method, keeping everything else the same.
  7849.           Notice the differences in the way the image evolves.  Start with
  7850.           a fairly low Maximum Hit limit, then increase it.  The hit limit
  7851.           cannot be higher than the maximum colors in your video mode.
  7852.  
  7853.   julia(fn||fn) (p. 63)
  7854.         z(0) = pixel;
  7855.         if modulus(z(n)) < shift value, then
  7856.            z(n+1) = fn1(z(n)) + c,
  7857.         else
  7858.            z(n+1) = fn2(z(n)) + c.
  7859.       Five parameters: real, imaginary portions of c, shift value,
  7860.                        fn1 and fn2.
  7861.  
  7862.   julia4 (p. 45)
  7863.       Fourth-power Julia set fractals, a special case
  7864.       of julzpower kept for speed.
  7865.         z(0) = pixel;
  7866.         z(n+1) = z(n)^4 + c.
  7867.       Two parameters: real and imaginary parts of c.
  7868.  
  7869.   julibrot (p. 57)
  7870.       'Julibrot' 4-dimensional fractals.
  7871.  
  7872.   julzpower (p. 45)
  7873.         z(0) = pixel;
  7874.         z(n+1) = z(n)^m + c.
  7875.       Three parameters: real & imaginary parts of c, exponent m
  7876.  
  7877.                       Fractint Version 19.2                       Page 144
  7878.  
  7879.   julzzpwr (p. 45)
  7880.         z(0) = pixel;
  7881.         z(n+1) = z(n)^z(n) + z(n)^m + c.
  7882.       Three parameters: real & imaginary parts of c, exponent m
  7883.  
  7884.   kamtorus, kamtorus3d (p. 48)
  7885.       Series of orbits superimposed.
  7886.       3d version has 'orbit' the z dimension.
  7887.         x(0) = y(0) = orbit/3;
  7888.         x(n+1) = x(n)*cos(a) + (x(n)*x(n)-y(n))*sin(a)
  7889.         y(n+1) = x(n)*sin(a) - (x(n)*x(n)-y(n))*cos(a)
  7890.       After each orbit, 'orbit' is incremented by a step size.
  7891.       Parameters: a, step size, stop value for 'orbit', and
  7892.       points per orbit.
  7893.  
  7894.   lambda (p. 39)
  7895.       Classic Lambda fractal. 'Julia' variant of Mandellambda.
  7896.         z(0) = pixel;
  7897.         z(n+1) = lambda*z(n)*(1 - z(n)).
  7898.       Two parameters: real and imaginary parts of lambda.
  7899.  
  7900.   lambdafn (p. 41)
  7901.         z(0) = pixel;
  7902.         z(n+1) = lambda * fn(z(n)).
  7903.       Three parameters: real, imag portions of lambda, and fn
  7904.  
  7905.   lambda(fn||fn) (p. 63)
  7906.         z(0) = pixel;
  7907.         if modulus(z(n)) < shift value, then
  7908.            z(n+1) = lambda * fn1(z(n)),
  7909.         else
  7910.            z(n+1) = lambda * fn2(z(n)).
  7911.       Five parameters: real, imaginary portions of lambda, shift value,
  7912.                        fn1 and fn2.
  7913.  
  7914.   lorenz, lorenz3d (p. 51)
  7915.       Lorenz two lobe attractor - orbit in three dimensions.
  7916.       In 2d the x and y components are projected to form the image.
  7917.         z(0) = y(0) = z(0) = 1;
  7918.         x(n+1) = x(n) + (-a*x(n)*dt) + (   a*y(n)*dt)
  7919.         y(n+1) = y(n) + ( b*x(n)*dt) - (     y(n)*dt) - (z(n)*x(n)*dt)
  7920.         z(n+1) = z(n) + (-c*z(n)*dt) + (x(n)*y(n)*dt)
  7921.       Parameters are dt, a, b, and c.
  7922.   lorenz3d1 (p. 51)
  7923.       Lorenz one lobe attractor - orbit in three dimensions.
  7924.       The original formulas were developed by Rick Miranda and Emily Stone.
  7925.         z(0) = y(0) = z(0) = 1; norm = sqrt(x(n)^2 + y(n)^2)
  7926.         x(n+1) = x(n) + (-a*dt-dt)*x(n) + (a*dt-b*dt)*y(n)
  7927.            + (dt-a*dt)*norm + y(n)*dt*z(n)
  7928.         y(n+1) = y(n) + (b*dt-a*dt)*x(n) - (a*dt+dt)*y(n)
  7929.            + (b*dt+a*dt)*norm - x(n)*dt*z(n) - norm*z(n)*dt
  7930.         z(n+1) = z(n) +(y(n)*dt/2) - c*dt*z(n)
  7931.       Parameters are dt, a, b, and c.
  7932.   lorenz3d3 (p. 51)
  7933.       Lorenz three lobe attractor - orbit in three dimensions.
  7934.       The original formulas were developed by Rick Miranda and Emily Stone.
  7935.  
  7936.                       Fractint Version 19.2                       Page 145
  7937.  
  7938.         z(0) = y(0) = z(0) = 1; norm = sqrt(x(n)^2 + y(n)^2)
  7939.         x(n+1) = x(n) +(-(a*dt+dt)*x(n) + (a*dt-b*dt+z(n)*dt)*y(n))/3
  7940.             + ((dt-a*dt)*(x(n)^2-y(n)^2)
  7941.             + 2*(b*dt+a*dt-z(n)*dt)*x(n)*y(n))/(3*norm)
  7942.         y(n+1) = y(n) +((b*dt-a*dt-z(n)*dt)*x(n) - (a*dt+dt)*y(n))/3
  7943.             + (2*(a*dt-dt)*x(n)*y(n)
  7944.             + (b*dt+a*dt-z(n)*dt)*(x(n)^2-y(n)^2))/(3*norm)
  7945.         z(n+1) = z(n) +(3*x(n)*dt*x(n)*y(n)-y(n)*dt*y(n)^2)/2 - c*dt*z(n)
  7946.       Parameters are dt, a, b, and c.
  7947.   lorenz3d4 (p. 51)
  7948.       Lorenz four lobe attractor - orbit in three dimensions.
  7949.       The original formulas were developed by Rick Miranda and Emily Stone.
  7950.         z(0) = y(0) = z(0) = 1;
  7951.         x(n+1) = x(n) +(-a*dt*x(n)^3
  7952.            + (2*a*dt+b*dt-z(n)*dt)*x(n)^2*y(n) + (a*dt-2*dt)*x(n)*y(n)^2
  7953.            + (z(n)*dt-b*dt)*y(n)^3) / (2 * (x(n)^2+y(n)^2))
  7954.         y(n+1) = y(n) +((b*dt-z(n)*dt)*x(n)^3 + (a*dt-2*dt)*x(n)^2*y(n)
  7955.            + (-2*a*dt-b*dt+z(n)*dt)*x(n)*y(n)^2
  7956.            - a*dt*y(n)^3) / (2 * (x(n)^2+y(n)^2))
  7957.         z(n+1) = z(n) +(2*x(n)*dt*x(n)^2*y(n) - 2*x(n)*dt*y(n)^3 - c*dt*z(n))
  7958.       Parameters are dt, a, b, and c.
  7959.  
  7960.   lsystem (p. 60)
  7961.       Using a turtle-graphics control language and starting with
  7962.       an initial axiom string, carries out string substitutions the
  7963.       specified number of times (the order), and plots the resulting.
  7964.  
  7965.   lyapunov (p. 62)
  7966.       Derived from the Bifurcation fractal, the Lyapunov plots the Lyapunov
  7967.       Exponent for a population model where the Growth parameter varies between
  7968.       two values in a periodic manner.
  7969.  
  7970.   magnet1j (p. 59)
  7971.         z(0) = pixel;
  7972.                   [  z(n)^2 + (c-1)  ] 2
  7973.         z(n+1) =  | ---------------- |
  7974.                   [  2*z(n) + (c-2)  ]
  7975.       Parameters: the real and imaginary parts of c
  7976.  
  7977.   magnet1m (p. 59)
  7978.         z(0) = 0; c = pixel;
  7979.                   [  z(n)^2 + (c-1)  ] 2
  7980.         z(n+1) =  | ---------------- |
  7981.                   [  2*z(n) + (c-2)  ]
  7982.       Parameters: the real & imaginary parts of perturbation of z(0)
  7983.  
  7984.   magnet2j (p. 59)
  7985.         z(0) = pixel;
  7986.                   [  z(n)^3 + 3*(C-1)*z(n) + (C-1)*(C-2)         ] 2
  7987.         z(n+1) =  |  -------------------------------------------- |
  7988.                   [  3*(z(n)^2) + 3*(C-2)*z(n) + (C-1)*(C-2) + 1 ]
  7989.       Parameters: the real and imaginary parts of c
  7990.   magnet2m (p. 59)
  7991.         z(0) = 0; c = pixel;
  7992.                   [  z(n)^3 + 3*(C-1)*z(n) + (C-1)*(C-2)         ] 2
  7993.         z(n+1) =  |  -------------------------------------------- |
  7994.  
  7995.                       Fractint Version 19.2                       Page 146
  7996.  
  7997.                   [  3*(z(n)^2) + 3*(C-2)*z(n) + (C-1)*(C-2) + 1 ]
  7998.       Parameters: the real and imaginary parts of perturbation of z(0)
  7999.  
  8000.   mandel (p. 33)
  8001.       Classic Mandelbrot set fractal.
  8002.         z(0) = c = pixel;
  8003.         z(n+1) = z(n)^2 + c.
  8004.       Two parameters: real & imaginary perturbations of z(0)
  8005.  
  8006.   mandel(fn||fn) (p. 63)
  8007.         c = pixel;
  8008.         z(0) = p1
  8009.         if modulus(z(n)) < shift value, then
  8010.            z(n+1) = fn1(z(n)) + c,
  8011.         else
  8012.            z(n+1) = fn2(z(n)) + c.
  8013.       Five parameters: real, imaginary portions of p1, shift value,
  8014.                        fn1 and fn2.
  8015.  
  8016.   mandelcloud (p. 65)
  8017.       Displays orbits of Mandelbrot set:
  8018.         z(0) = c = pixel;
  8019.         z(n+1) = z(n)^2 + c.
  8020.       One parameter: number of intervals
  8021.  
  8022.   mandel4 (p. 45)
  8023.       Special case of mandelzpower kept for speed.
  8024.         z(0) = c = pixel;
  8025.         z(n+1) = z(n)^4 + c.
  8026.       Parameters: real & imaginary perturbations of z(0)
  8027.  
  8028.   mandelfn (p. 42)
  8029.         z(0) = c = pixel;
  8030.         z(n+1) = c*fn(z(n)).
  8031.       Parameters: real & imaginary perturbations of z(0), and fn
  8032.  
  8033.   manlam(fn||fn) (p. 63)
  8034.         c = pixel;
  8035.         z(0) = p1
  8036.         if modulus(z(n)) < shift value, then
  8037.            z(n+1) = fn1(z(n)) * c, else
  8038.            z(n+1) = fn2(z(n)) * c.
  8039.       Five parameters: real, imaginary parts of p1, shift value, fn1, fn2.
  8040.  
  8041.   Martin (p. 53)
  8042.       Attractor fractal by Barry Martin - orbit in two dimensions.
  8043.         z(0) = y(0) = 0;
  8044.         x(n+1) = y(n) - sin(x(n))
  8045.         y(n+1) = a - x(n)
  8046.       Parameter is a (try a value near pi)
  8047.  
  8048.   mandellambda (p. 39)
  8049.         z(0) = .5; lambda = pixel;
  8050.         z(n+1) = lambda*z(n)*(1 - z(n)).
  8051.       Parameters: real & imaginary perturbations of z(0)
  8052.   mandphoenix (p. 68)
  8053.  
  8054.                       Fractint Version 19.2                       Page 147
  8055.  
  8056.       z(0) = c = pixel, y(0) = 0;
  8057.       For degree = 0:
  8058.         z(n+1) = z(n)^2 + c.x + c.y*y(n), y(n+1) = z(n)
  8059.       For degree >= 2:
  8060.         z(n+1) = z(n)^degree + c.x*z(n)^(degree-1) + c.y*y(n)
  8061.         y(n+1) = z(n)
  8062.       For degree <= -3:
  8063.         z(n+1) = z(n)^|degree| + c.x*z(n)^(|degree|-2) + c.y*y(n)
  8064.         y(n+1) = z(n)
  8065.       Three parameters: real & imaginary perturbations of z(0), and degree.
  8066.  
  8067.   mandphoenixclx (p. 68)
  8068.       z(0) = c = pixel, y(0) = 0;
  8069.       For degree = 0:
  8070.         z(n+1) = z(n)^2 + c + p2*y(n), y(n+1) = z(n)
  8071.       For degree >= 2:
  8072.         z(n+1) = z(n)^degree + c*z(n)^(degree-1) + p2*y(n), y(n+1) = z(n)
  8073.       For degree <= -3:
  8074.         z(n+1) = z(n)^|degree| + c*z(n)^(|degree|-2) + p2*y(n), y(n+1) = z(n)
  8075.       Five parameters: real & imaginary perturbations of z(0), real &
  8076.         imaginary parts of p2, and degree.
  8077.   manfn+exp (p. 45)
  8078.       'Mandelbrot-Equivalent' for the julfn+exp fractal.
  8079.         z(0) = c = pixel;
  8080.         z(n+1) = fn(z(n)) + e^z(n) + C.
  8081.       Parameters: real & imaginary perturbations of z(0), and fn
  8082.  
  8083.   manfn+zsqrd (p. 45)
  8084.       'Mandelbrot-Equivalent' for the Julfn+zsqrd fractal.
  8085.         z(0) = c = pixel;
  8086.         z(n+1) = fn(z(n)) + z(n)^2 + c.
  8087.       Parameters: real & imaginary perturbations of z(0), and fn
  8088.  
  8089.   manowar (p. 47)
  8090.         c = z1(0) = z(0) = pixel;
  8091.         z(n+1) = z(n)^2 + z1(n) + c;
  8092.         z1(n+1) = z(n);
  8093.       Parameters: real & imaginary perturbations of z(0)
  8094.   manowarj (p. 47)
  8095.         z1(0) = z(0) = pixel;
  8096.         z(n+1) = z(n)^2 + z1(n) + c;
  8097.         z1(n+1) = z(n);
  8098.       Parameters: real & imaginary parts of c
  8099.  
  8100.   manzpower (p. 45)
  8101.       'Mandelbrot-Equivalent' for julzpower.
  8102.         z(0) = c = pixel;
  8103.         z(n+1) = z(n)^exp + c; try exp = e = 2.71828...
  8104.       Parameters: real & imaginary perturbations of z(0), real &
  8105.       imaginary parts of exponent exp.
  8106.  
  8107.   manzzpwr (p. 45)
  8108.       'Mandelbrot-Equivalent' for the julzzpwr fractal.
  8109.         z(0) = c = pixel
  8110.         z(n+1) = z(n)^z(n) + z(n)^exp + C.
  8111.       Parameters: real & imaginary perturbations of z(0), and exponent
  8112.  
  8113.                       Fractint Version 19.2                       Page 148
  8114.  
  8115.   marksjulia (p. 46)
  8116.       A variant of the julia-lambda fractal.
  8117.         z(0) = pixel;
  8118.         z(n+1) = (c^exp-1)*z(n)^2 + c.
  8119.       Parameters: real & imaginary parts of c, and exponent
  8120.  
  8121.   marksmandel (p. 46)
  8122.       A variant of the mandel-lambda fractal.
  8123.         z(0) = c = pixel;
  8124.         z(n+1) = (c^exp-1)*z(n)^2 + c.
  8125.       Parameters: real & imaginary parts of perturbations of z(0),
  8126.       and exponent
  8127.  
  8128.   marksmandelpwr (p. 46)
  8129.       The marksmandelpwr formula type generalized (it previously
  8130.       had fn=sqr hard coded).
  8131.         z(0) = pixel, c = z(0) ^ (z(0) - 1):
  8132.         z(n+1) = c * fn(z(n)) + pixel,
  8133.       Parameters: real and imaginary perturbations of z(0), and fn
  8134.  
  8135.   newtbasin (p. 37)
  8136.       Based on the Newton formula for finding the roots of z^p - 1.
  8137.       Pixels are colored according to which root captures the orbit.
  8138.         z(0) = pixel;
  8139.         z(n+1) = ((p-1)*z(n)^p + 1)/(p*z(n)^(p - 1)).
  8140.       Two parameters: the polynomial degree p, and a flag to turn
  8141.       on color stripes to show alternate iterations.
  8142.  
  8143.   newton (p. 38)
  8144.       Based on the Newton formula for finding the roots of z^p - 1.
  8145.       Pixels are colored according to the iteration when the orbit
  8146.       is captured by a root.
  8147.         z(0) = pixel;
  8148.         z(n+1) = ((p-1)*z(n)^p + 1)/(p*z(n)^(p - 1)).
  8149.       One parameter: the polynomial degree p.
  8150.  
  8151.   phoenix (p. 68)
  8152.       z(0) = pixel, y(0) = 0;
  8153.       For degree = 0: z(n+1) = z(n)^2 + p1.x + p2.x*y(n), y(n+1) = z(n)
  8154.       For degree >= 2:
  8155.        z(n+1) = z(n)^degree + p1.x*z(n)^(degree-1) + p2.x*y(n), y(n+1) = z(n)
  8156.       For degree <= -3:
  8157.        z(n+1) = z(n)^|degree| + p1.x*z(n)^(|degree|-2) + p2.x*y(n), y(n+1) = z(n)
  8158.       Three parameters: real parts of p1 & p2, and degree.
  8159.  
  8160.   phoenixcplx (p. 68)
  8161.       z(0) = pixel, y(0) = 0;
  8162.       For degree = 0: z(n+1) = z(n)^2 + p1 + p2*y(n), y(n+1) = z(n)
  8163.       For degree >= 2:
  8164.         z(n+1) = z(n)^degree + p1*z(n)^(degree-1) + p2*y(n), y(n+1) = z(n)
  8165.       For degree <= -3:
  8166.         z(n+1) = z(n)^|degree| + p1*z(n)^(|degree|-2) + p2*y(n), y(n+1) = z(n)
  8167.       Five parameters: real & imaginary parts of p1 & p2, and degree.
  8168.   pickover (p. 53)
  8169.       Orbit in three dimensions defined by:
  8170.         x(n+1) = sin(a*y(n)) - z(n)*cos(b*x(n))
  8171.  
  8172.                       Fractint Version 19.2                       Page 149
  8173.  
  8174.         y(n+1) = z(n)*sin(c*x(n)) - cos(d*y(n))
  8175.         z(n+1) = sin(x(n))
  8176.       Parameters: a, b, c, and d.
  8177.   plasma (p. 40)
  8178.       Random, cloud-like formations.  Requires 4 or more colors.
  8179.       A recursive algorithm repeatedly subdivides the screen and
  8180.       colors pixels according to an average of surrounding pixels
  8181.       and a random color, less random as the grid size decreases.
  8182.       Four parameters: 'graininess' (.5 to 50, default = 2), old/new
  8183.       algorithm, seed value used, 16-bit out output selection.
  8184.  
  8185.   popcorn (p. 46)
  8186.       The orbits in two dimensions defined by:
  8187.         x(0) = xpixel, y(0) = ypixel;
  8188.         x(n+1) = x(n) - h*sin(y(n) + tan(3*y(n))
  8189.         y(n+1) = y(n) - h*sin(x(n) + tan(3*x(n))
  8190.       are plotted for each screen pixel and superimposed.
  8191.       One parameter: step size h.
  8192.  
  8193.   popcornjul (p. 46)
  8194.       Conventional Julia using the popcorn formula:
  8195.         x(0) = xpixel, y(0) = ypixel;
  8196.         x(n+1) = x(n) - h*sin(y(n) + tan(3*y(n))
  8197.         y(n+1) = y(n) - h*sin(x(n) + tan(3*x(n))
  8198.       One parameter: step size h.
  8199.  
  8200.   quadruptwo (p. 53)
  8201.       Quadruptwo attractor from Michael Peters - orbit in two dimensions.
  8202.         z(0) = y(0) = 0;
  8203.         x(n+1) = y(n) - sign(x(n)) * sin(ln(abs(b*x(n)-c)))
  8204.                                    * arctan(sqr(ln(abs(c*x(n)-b))))
  8205.         y(n+1) = a - x(n)
  8206.       Parameters are a, b, and c.
  8207.   quatjul (p. 65)
  8208.       Quaternion Julia set.
  8209.         q(0)   = (xpixel,ypixel,zj,zk)
  8210.         q(n+1) = q(n)*q(n) + c.
  8211.       Four parameters: c, ci, cj, ck
  8212.       c = (c1,ci,cj,ck)
  8213.  
  8214.   quat (p. 65)
  8215.       Quaternion Mandelbrot set.
  8216.         q(0)   = (0,0,0,0)
  8217.         q(n+1) = q(n)*q(n) + c.
  8218.       Two parameters: cj,ck
  8219.       c = (xpixel,ypixel,cj,ck)
  8220.  
  8221.   rossler3D (p. 52)
  8222.       Orbit in three dimensions defined by:
  8223.         x(0) = y(0) = z(0) = 1;
  8224.         x(n+1) = x(n) - y(n)*dt -   z(n)*dt
  8225.         y(n+1) = y(n) + x(n)*dt + a*y(n)*dt
  8226.         z(n+1) = z(n) + b*dt + x(n)*z(n)*dt - c*z(n)*dt
  8227.       Parameters are dt, a, b, and c.
  8228.   sierpinski (p. 44)
  8229.       Sierpinski gasket - Julia set producing a 'Swiss cheese triangle'
  8230.  
  8231.                       Fractint Version 19.2                       Page 150
  8232.  
  8233.         z(n+1) = (2*x,2*y-1) if y > .5;
  8234.             else (2*x-1,2*y) if x > .5;
  8235.             else (2*x,2*y)
  8236.       No parameters.
  8237.  
  8238.   spider (p. 47)
  8239.         c(0) = z(0) = pixel;
  8240.         z(n+1) = z(n)^2 + c(n);
  8241.         c(n+1) = c(n)/2 + z(n+1)
  8242.       Parameters: real & imaginary perturbation of z(0)
  8243.  
  8244.   sqr(1/fn) (p. 47)
  8245.         z(0) = pixel;
  8246.         z(n+1) = (1/fn(z(n))^2
  8247.       One parameter: the function fn.
  8248.  
  8249.   sqr(fn) (p. 47)
  8250.         z(0) = pixel;
  8251.         z(n+1) = fn(z(n))^2
  8252.       One parameter: the function fn.
  8253.   test (p. 54)
  8254.       'test' point letting us (and you!) easily add fractal types via
  8255.       the c module testpt.c.  Default set up is a mandelbrot fractal.
  8256.       Four parameters: user hooks (not used by default testpt.c).
  8257.  
  8258.   tetrate (p. 47)
  8259.         z(0) = c = pixel;
  8260.         z(n+1) = c^z(n)
  8261.       Parameters: real & imaginary perturbation of z(0)
  8262.  
  8263.   threeply (p. 53)
  8264.       Threeply attractor by Michael Peters - orbit in two dimensions.
  8265.         z(0) = y(0) = 0;
  8266.         x(n+1) = y(n) - sign(x(n)) * (abs(sin(x(n))*cos(b)
  8267.                                       +c-x(n)*sin(a+b+c)))
  8268.         y(n+1) = a - x(n)
  8269.       Parameters are a, b, and c.
  8270.   tim's_error (p. 46)
  8271.       A serendipitous coding error in marksmandelpwr brings to life
  8272.       an ancient pterodactyl!  (Try setting fn to sqr.)
  8273.         z(0) = pixel, c = z(0) ^ (z(0) - 1):
  8274.         tmp = fn(z(n))
  8275.         real(tmp) = real(tmp) * real(c) - imag(tmp) * imag(c);
  8276.         imag(tmp) = real(tmp) * imag(c) - imag(tmp) * real(c);
  8277.         z(n+1) = tmp + pixel;
  8278.       Parameters: real & imaginary perturbations of z(0) and function fn
  8279.  
  8280.   unity (p. 47)
  8281.         z(0) = pixel;
  8282.         x = real(z(n)), y = imag(z(n))
  8283.         One = x^2 + y^2;
  8284.         y = (2 - One) * x;
  8285.         x = (2 - One) * y;
  8286.         z(n+1) = x + i*y
  8287.       No parameters.
  8288.  
  8289.                       Fractint Version 19.2                       Page 151
  8290.  
  8291.   INSIDE=BOF60|BOF61|ZMAG|PERIOD
  8292.  
  8293.   Here is an *ATTEMPTED* explanation of what the inside=bof60 and
  8294.   inside=bof61 options do. This explanation is hereby dedicated to Adrian
  8295.   Mariano, who badgered it out of us! For the *REAL* explanation, see
  8296.   "Beauty of Fractals", page 62.
  8297.  
  8298.   Let p(z) be the function that is repeatedly iterated to generate a
  8299.   fractal using the escape-time algorithm.  For example, p(z) = z^2+c in
  8300.   the case of a Julia set. Then let pk(z) be the result of iterating the
  8301.   function p for k iterations. (The "k" should be shown as a superscript.)
  8302.   We could also use the notation pkc(z) when the function p has a
  8303.   parameter c, as it does in our example.  Now hold your breath and get
  8304.   your thinking cap on. Define a(c) = inf{|pkc(0)|:k=1,2,3,...}. In
  8305.   English - a(c) is the greatest lower bound of the images of zero of as
  8306.   many iterations as you like. Put another way, a(c) is the closest to the
  8307.   origin any point in the orbit starting with 0 gets. Then the index (c)
  8308.   is the value of k (the iteration) when that closest point was achieved.
  8309.   Since there may be more than one, index(c) is the least such. Got it?
  8310.   Good, because the "Beauty of Fractals" explanation of this, is, ahhhh,
  8311.   *TERSE* ! Now for the punch line. Inside=bof60 colors the lake
  8312.   alternating shades according to the level sets of a(c).  Each band
  8313.   represents solid areas of the fractal where the closest value of the
  8314.   orbit to the origin is the same.  Inside=bof61 show domains where
  8315.   index(c) is constant.  That is, areas where the iteration when the orbit
  8316.   swooped closest to the origin has the same value.  Well, folks, that's
  8317.   the best we can do! Improved explanations will be accepted for the next
  8318.   edition!
  8319.  
  8320.   In response to this request for lucidity, Herb Savage offers this
  8321.   explanation the bof60 and bof61 options:
  8322.  
  8323.    The picture on page 60 of The Beauty of Fractals shows the distance to
  8324.    origin of the closest point to the origin in the sequence of points
  8325.    generated from a given X,Y coordinate.  The picture on page 61 shows
  8326.    the index (or number) in the sequence of the closest point.
  8327.  
  8328.   inside=zmag is similar. This option colors inside pixels according to
  8329.   the magnitude of the orbit point when maxiter was reached, using the
  8330.   formula color = (x^2 + y^2) * maxiter/2 + 1.
  8331.  
  8332.   inside=period colors pixels according to the length of their eventual
  8333.   cycle.  For example, points that approach a fixed point have color=1.
  8334.   Points that approach a 2-cycle have color=2.  Points that do not
  8335.   approach a cycle during the iterations performed have color=maxit.  This
  8336.   option works best with a fairly large number of iterations.
  8337.  
  8338.   INSIDE=EPSCROSS|STARTRAIL
  8339.  
  8340.   Kenneth Hooper has written a paper entitled "A Note On Some Internal
  8341.   Structures Of The Mandelbrot Set" published in "Computers and Graphics",
  8342.   Vol 15, No.2, pp. 295-297.  In that article he describes Clifford
  8343.   Pickover's "epsilon cross" method which creates some mysterious plant-
  8344.   like tendrils in the Mandelbrot set. The algorithm is this. In the
  8345.   escape-time calculation of a fractal, if the orbit comes within .01 of
  8346.   the Y-axis, the orbit is terminated and the pixel is colored green.
  8347.  
  8348.                       Fractint Version 19.2                       Page 152
  8349.  
  8350.   Similarly, the pixel is colored yellow if it approaches the X-axis.
  8351.   Strictly speaking, this is not an "inside" option because a point
  8352.   destined to escape could be caught by this bailout criterion.
  8353.  
  8354.   Hooper has another coloring scheme called "star trails" that involves
  8355.   detecting clusters of points being traversed by the orbit. A table of
  8356.   tangents of each orbit point is built, and the pixel colored according
  8357.   to how many orbit points are near the first one before the orbit flies
  8358.   out of the cluster.  This option looks fine with maxiter=16, which
  8359.   greatly speeds the calculation.
  8360.  
  8361.   Both of these options should be tried with the outside color fixed
  8362.   (outside=<nnn>) so that the "lake" structure revealed by the algorithms
  8363.   can be more clearly seen. Epsilon Cross is fun to watch with boundary
  8364.   tracing turned on - even though the result is incorrect it is
  8365.   interesting! Shucks - what does "incorrect" mean in chaos theory
  8366.   anyway?!
  8367.  
  8368.   FINITE ATTRACTORS
  8369.  
  8370.   Many of Fractint's fractals involve the iteration of functions of
  8371.   complex numbers until some "bailout" value is exceeded, then coloring
  8372.   the associated pixel according to the number of iterations performed.
  8373.   This process identifies which values tend to infinity when iterated, and
  8374.   gives us a rough measure of how "quickly" they get there.
  8375.  
  8376.   In dynamical terms, we say that "Infinity is an Attractor", as many
  8377.   initial values get "attracted" to it when iterated.  The set of all
  8378.   points that are attracted to infinity is termed The Basin of Attraction
  8379.   of Infinity.  The coloring algorithm used divides this Basin of
  8380.   Attraction into many distinct sets, each a single band of one color,
  8381.   representing all the points that are "attracted" to Infinity at the same
  8382.   "rate".  These sets (bands of color) are termed "Level Sets" - all
  8383.   points in such a set are at the same "Level" away from the attractor, in
  8384.   terms of numbers of iterations required to exceed the bailout value.
  8385.  
  8386.   Thus, Fractint produces colored images of the Level Sets of the Basin of
  8387.   Attraction of Infinity, for all fractals that iterate functions of
  8388.   Complex numbers, at least.  Now we have a sound mathematical definition
  8389.   of what Fractint's "bailout" processing generates, and we have formally
  8390.   introduced the terms Attractor, Basin of Attraction, and Level Set, so
  8391.   you should have little trouble following the rest of this section!
  8392.  
  8393.   For certain Julia-type fractals, Fractint can also display the Level
  8394.   Sets of Basins of Attraction of Finite Attractors.  This capability is a
  8395.   by-product of the implementation of the MAGNETic fractal types, which
  8396.   always have at least one Finite Attractor.
  8397.  
  8398.   This option can be invoked by setting the "Look for finite attractor"
  8399.   option on the <Y> options screen, or by giving the "finattract=yes"
  8400.   command-line option.
  8401.  
  8402.   Most Julia-types that have a "lake" (normally colored blue by default)
  8403.   have a Finite Attractor within this lake, and the lake turns out to be,
  8404.   quite appropriately, the Basin of Attraction of this Attractor.
  8405.  
  8406.                       Fractint Version 19.2                       Page 153
  8407.  
  8408.   The "finattract=yes" option (command-line or <Y> options screen)
  8409.   instructs Fractint to seek out and identify a possible Finite Attractor
  8410.   and, if found, to display the Level Sets of its Basin of Attraction, in
  8411.   addition to those of the Basin of Attraction of Infinity.  In many cases
  8412.   this results in a "lake" with colored "waves" in it;  in other cases
  8413.   there may be little change in the lake's appearance.
  8414.  
  8415.   For a quick demonstration, select a fractal type of LAMBDA, with a
  8416.   parameter of 0.5 + 0.5i.  You will obtain an image with a large blue
  8417.   lake.  Now set "Look for finite attractor" to 1 with the "Y" menu.  The
  8418.   image will be re-drawn with a much more colorful lake.  A Finite
  8419.   Attractor lives in the center of one of the resulting "ripple" patterns
  8420.   in the lake - turn the <O>rbits display on to see where it is - the
  8421.   orbits of all initial points that are in the lake converge there.
  8422.  
  8423.   Fractint tests for the presence of a Finite Attractor by iterating a
  8424.   Critical Value of the fractal's function.  If the iteration doesn't bail
  8425.   out before exceeding twice the iteration limit, it is almost certain
  8426.   that we have a Finite Attractor - we assume that we have.
  8427.  
  8428.   Next we define a small circle around it and, after each iteration, as
  8429.   well as testing for the usual bailout value being exceeded, we test to
  8430.   see if we've hit the circle. If so, we bail out and color our pixels
  8431.   according to the number of iterations performed.  Result - a nicely
  8432.   colored-in lake that displays the Level Sets of the Basin of Attraction
  8433.   of the Finite Attractor.  Sometimes !
  8434.  
  8435.   First exception: This does not work for the lakes of Mandel-types.
  8436.   Every point in a Mandel-type is, in effect, a single point plucked from
  8437.   one of its related Julia-types.  A Mandel-type's lake has an infinite
  8438.   number of points, and thus an infinite number of related Julia-type
  8439.   sets, and consequently an infinite number of finite attractors too.  It
  8440.   *MAY* be possible to color in such a lake, by determining the attractor
  8441.   for EVERY pixel, but this would probably treble (at least) the number of
  8442.   iterations needed to draw the image.  Due to this overhead, Finite
  8443.   Attractor logic has not been implemented for Mandel-types.
  8444.  
  8445.   Secondly, certain Julia-types with lakes may not respond to this
  8446.   treatment, depending on the parameter value used.  E.g., the Lambda Set
  8447.   for 0.5 + 0.5i responds well; the Lambda Set for 0.0 + 1.0i does not -
  8448.   its lake stays blue.  Attractors that consist of single points, or a
  8449.   cycle of a finite number of points are ok.  Others are not.  If you're
  8450.   into fractal technospeak, the implemented approach fails if the Julia-
  8451.   type is a Parabolic case, or has Siegel Disks, or has Herman Rings.
  8452.  
  8453.   However, all the difficult cases have one thing in common - they all
  8454.   have a parameter value that falls exactly on the edge of the related
  8455.   Mandel-type's lake.  You can avoid them by intelligent use of the
  8456.   Mandel-Julia Space-Bar toggle:  Pick a view of the related Mandel-type
  8457.   where the center of the screen is inside the lake, but not too close to
  8458.   its edge, then use the space-bar toggle.  You should obtain a usable
  8459.   Julia-type with a lake, if you follow this guideline.
  8460.  
  8461.   Thirdly, the initial implementation only works for Julia-types that use
  8462.   the "Standard" fractal engine in Fractint.  Fractals with their own
  8463.   special algorithms are not affected by Finite Attractor logic, as yet.
  8464.  
  8465.                       Fractint Version 19.2                       Page 154
  8466.  
  8467.   Finally, the finite attractor code will not work if it fails to detect a
  8468.   finite attractor.  If the number of iterations is set too low, the
  8469.   finite attractor may be missed.
  8470.  
  8471.   Despite these restrictions, the Finite Attractor logic can produce
  8472.   interesting results.  Just bear in mind that it is principally a bonus
  8473.   off-shoot from the development of the MAGNETic fractal types, and is not
  8474.   specifically tuned for optimal performance for other Julia types.
  8475.  
  8476.   (Thanks to Kevin Allen for the above).
  8477.  
  8478.   There is a second type of finite attractor coloring, which is selected
  8479.   by setting "Look for Finite Attractor" to a negative value.  This colors
  8480.   points by the phase of the convergence to the finite attractor, instead
  8481.   of by the speed of convergence.
  8482.  
  8483.   For example, consider the Julia set for -0.1 + 0.7i, which is the three-
  8484.   lobed "rabbit" set.  The Finite Attractor is an orbit of length three;
  8485.   call these values a, b, and c.  Then, the Julia set iteration can
  8486.   converge to one of three sequences: a,b,c,a,b,c,..., or b,c,a,b,c,...,
  8487.   or c,a,b,c,a,b,...  The Finite Attractor phase option colors the
  8488.   interior of the Julia set with three colors, depending on which of the
  8489.   three sequences the orbit converges to.  Internally, the code determines
  8490.   one point of the orbit, say "a", and the length of the orbit cycle, say
  8491.   3.  It then iterates until the sequence converges to a, and then uses
  8492.   the iteration number modulo 3 to determine the color.
  8493.  
  8494.  
  8495.   TRIG IDENTITIES
  8496.  
  8497.   The following trig identities are invaluable for coding fractals that
  8498.   use complex-valued transcendental functions of a complex variable in
  8499.   terms of real-valued functions of a real variable, which are usually
  8500.   found in compiler math libraries. In what follows, we sometimes use "*"
  8501.   for multiplication, but leave it out when clarity is not lost. We use
  8502.   "^" for exponentiation; x^y is x to the y power.
  8503.  
  8504.      (u+iv) + (x+iy) = (u+x) + i(v+y)
  8505.      (u+iv) - (x+iy) = (u-x) + i(v-y)
  8506.      (u+iv) * (x+iy) = (ux - vy) + i(vx + uy)
  8507.      (u+iv) / (x+iy) = ((ux + vy) + i(vx - uy)) / (x^2 + y^2)
  8508.  
  8509.      e^(x+iy)   = (e^x) (cos(y) + i sin(y))
  8510.  
  8511.      log(x+iy) = (1/2)log(x*x + y*y) + i(atan(y/x) + 2kPi)
  8512.         for k = 0, -1, 1, -2, 2, ...
  8513.          (Fractint generally uses only the principle value, k=0. The log
  8514.           function refers to log base e, or ln.)
  8515.  
  8516.      z^w = e^(w*log(z))
  8517.  
  8518.      sin(x+iy)  = sin(x)cosh(y) + i cos(x)sinh(y)
  8519.      cos(x+iy)  = cos(x)cosh(y) - i sin(x)sinh(y)
  8520.      tan(x+iy)  = sin(x+iy) / cos(x+iy)
  8521.      sinh(x+iy) = sinh(x)cos(y) + i cosh(x)sin(y)
  8522.      cosh(x+iy) = cosh(x)cos(y) + i sinh(x)sin(y)
  8523.  
  8524.                       Fractint Version 19.2                       Page 155
  8525.  
  8526.      tanh(x+iy) = sinh(x+iy) / cosh(x+iy)
  8527.      cosxx(x+iy) = cos(x)cosh(y) + i sin(x)sinh(y)
  8528.        (cosxx is present in Fractint to provide compatibility with a bug
  8529.        which was in its cos calculation before version 16)
  8530.  
  8531.                        sin(2x)               sinh(2y)
  8532.      tan(x+iy) = ------------------  + i------------------
  8533.                  cos(2x) + cosh(2y)     cos(2x) + cosh(2y)
  8534.  
  8535.                    sin(2x) - i*sinh(2y)
  8536.      cotan(x+iy) = --------------------
  8537.                     cosh(2y) - cos(2x)
  8538.  
  8539.                       sinh(2x)                sin(2y)
  8540.      tanh(x+iy) = ------------------ + i------------------
  8541.                   cosh(2x) + cos(2y)    cosh(2x) + cos(2y)
  8542.  
  8543.                     sinh(2x) - i*sin(2y)
  8544.      cotanh(x+iy) = --------------------
  8545.                      cosh(2x) - cos(2y)
  8546.  
  8547.      asin(z) = -i * log(i*z+sqrt(1-z*z))
  8548.      acos(z) = -i * log(z+sqrt(z*z-1))
  8549.      atan(z) = i/2* log((1-i*z)/(1+i*z))
  8550.  
  8551.      asinh(z) = log(z+sqrt(z*z+1))
  8552.      acosh(z) = log(z+sqrt(z*z-1))
  8553.      atanh(z) = 1/2*log((1+z)/(1-z))
  8554.  
  8555.      sqr(x+iy) = (x^2-y^2) + i*2xy
  8556.      sqrt(x+iy) = sqrt(sqrt(x^2+y^2)) * (cos(atan(y/x)/2) + i sin(atan(y/x)/2))
  8557.  
  8558.      ident(x+iy) = x+iy
  8559.      conj(x+iy) = x-iy
  8560.      recip(x+iy) = (x-iy)/(x^2+y^2)
  8561.      flip(x+iy) = y+ix
  8562.      zero(x+iy) = 0
  8563.      cabs(x+iy) = sqrt(x^2 + y^2)
  8564.  
  8565.   Fractint's definitions of abs(x+iy) and |x+iy| below are non-standard.
  8566.   Math texts define both absolute value and modulus of a complex number to
  8567.   be the same thing.  They are both equal to cabs(x+iy) as defined above.
  8568.  
  8569.      |x+iy| = x^2 + y^2
  8570.      abs(x+iy) = sqrt(x^2) + i sqrt(y^2)
  8571.  
  8572.   Quaternions are four dimensional generalizations of complex numbers.
  8573.   They almost obey the familiar field properties of real numbers, but fail
  8574.   the commutative law of multiplication, since x*y is not generally equal
  8575.   to y*x.
  8576.  
  8577.   Quaternion algebra is most compactly described by specifying the rules
  8578.   for multiplying the basis vectors 1, i, j, and k. Quaternions form a
  8579.   superset of the complex numbers, and the basis vectors 1 and i are the
  8580.   familiar basis vectors for the complex algebra. Any quaternion q can be
  8581.   represented as a linear combination q = x + yi + zj + wk of the basis
  8582.  
  8583.                       Fractint Version 19.2                       Page 156
  8584.  
  8585.   vectors just as any complex number can be written in the form z = a +
  8586.   bi.
  8587.  
  8588.   Multiplication rules for quaternion basis vectors:
  8589.   ij =  k jk =  i ki = j
  8590.   ji = -k kj = -i ik = -j
  8591.   ii = jj = kk = -1
  8592.   ijk = -1
  8593.  
  8594.   Note that ij = k but ji = -k, showing the failure of the commutative law.
  8595.   The rules for multiplying any two quaternions follow from the behavior
  8596.   of the basis vectors just described. However, for your convenience, the
  8597.   following formula works out the details.
  8598.  
  8599.   Let q1 = x1 + y1i + z1j + w1k and q2 = x2 + y2i + z2j + w2k.
  8600.   Then q1q2 = 1(x1x2 - y1y2 - z1z2 - w1w2) +
  8601.               i(y1x2 + x1y2 + w1z2 - z1w2) +
  8602.               j(z1x2 - w1y2 + x1z2 + y1w2) +
  8603.               k(w1x2 + z1y2 - y1z2 + x1w2)
  8604.  
  8605.   Quaternions are not the only possible four dimensional supersets of the
  8606.   complex numbers. William Hamilton, the discoverer of quaternions in the
  8607.   1830's, considered the alternative called the hypercomplex number
  8608.   system.  Unlike quaternions, the hypercomplex numbers satisfy the
  8609.   commutative law of multiplication. The law which fails is the field
  8610.   property that states that all non-zero elements of a field have a
  8611.   multiplicative inverse. For a non-zero hypercomplex number h, the
  8612.   multiplicative inverse 1/h does not always exist.
  8613.  
  8614.   As with quaternions, we will define multiplication in terms of the basis
  8615.   vectors 1, i, j, and k, but with subtly different rules.
  8616.  
  8617.   Multiplication rules for hypercomplex basis vectors:
  8618.   ij = k  jk = -i ki = -j
  8619.   ji = k  kj = -i ik = -j
  8620.   ii = jj = -kk = -1
  8621.   ijk = 1
  8622.  
  8623.   Note that now ij = k and ji = k, and similarly for other products of pairs
  8624.   of basis vectors, so the commutative law holds.
  8625.  
  8626.   Hypercomplex multiplication formula:
  8627.   Let h1 = x1 + y1i + z1j + w1k and h2 = x2 + y2i + z2j + w2k.
  8628.   Then  h1h2 =  1(x1x2 - y1y2 - z1z2 + w1w2) +
  8629.                 i(y1x2 + x1y2 - w1z2 - z1w2) +
  8630.                 j(z1x2 - w1y2 + x1z2 - y1w2) +
  8631.                 k(w1x2 + z1y2 + y1z2 + x1w2)
  8632.  
  8633.   As an added bonus, we'll give you the formula for the reciprocal.
  8634.  
  8635.   Let det = [((x-w)^2+(y+z)^2)((x+w)^2+(y-z)^2)]
  8636.   Then 1/h =   1[ x(x^2+y^2+z^2+w^2)-2w(xw-yz)]/det +
  8637.                i[-y(x^2+y^2+z^2+w^2)-2z(xw-yz)]/det +
  8638.                j[-z(x^2+y^2+z^2+w^2)-2y(xw-yz)]/det +
  8639.                k[ w(x^2+y^2+z^2+w^2)-2x(xw-yz)]/det
  8640.  
  8641.                       Fractint Version 19.2                       Page 157
  8642.  
  8643.   A look at this formula shows the difficulty with hypercomplex numbers.
  8644.   In order to calculate 1/h, you have to divide by the quantity det =
  8645.   [((x-w)^2+(y+z)^2)((x+w)^2+(y-z)^2)]. So when this quantity is zero, the
  8646.   multiplicative inverse will not exist.
  8647.  
  8648.   Hypercomplex numbers numbers have an elegant generalization of any unary
  8649.   complex valued function defined on the complex numbers. First, note that
  8650.   hypercomplex numbers can be represented as a pair of complex numbers in
  8651.   the following way.
  8652.   Let h = x + yi + zj + wk.
  8653.       a = (x-w) + i(y+z)
  8654.       b = (x+w) + i(y-z)
  8655.   The numbers a and b are complex numbers. We can represent h as the pair
  8656.   of complex numbers (a,b). Conversely, if we have a hypercomplex number
  8657.   given to us in the form (a,b), we can solve for x, y, z, and w. The
  8658.   solution to
  8659.      c = (x-w) + i(y+z)
  8660.      d = (x+w) + i(y-z)
  8661.   is
  8662.      x = (real(c) + real(d))/2
  8663.      y = (imag(c) + imag(d))/2
  8664.      z = (imag(c) - imag(d))/2
  8665.      x = (real(d) - real(c))/2
  8666.   We can now, for example, define sin(h) as (sin(a),sin(b)). We know how
  8667.   to compute sin(a) and sin(b) (see trig identities above).
  8668.  
  8669.   Let c = sin(a) and d = sin(b). Now use the equations above to solve for
  8670.   x, y, z, and w in terms of c and d. The beauty of this is that it really
  8671.   doesn't make any difference what function we use. Instead of sin, we
  8672.   could have used cos, sinh, ln, or z^2. Using this technique, Fractint
  8673.   can create 3-D fractals using the formula h' = fn(h) + c, where "fn" is
  8674.   any of the built-in functions. Where fn is sqr(), this is the famous
  8675.   mandelbrot formula, generalized to four dimensions.
  8676.  
  8677.   For more information, see _Fractal Creations, Second Edition_ by Tim
  8678.   Wegner and Bert Tyler, Waite Group Press, 1993.
  8679.  
  8680.                       Fractint Version 19.2                       Page 158
  8681.  
  8682.  Appendix B Stone Soup With Pixels: The Authors
  8683.  
  8684.   THE STONE SOUP STORY
  8685.  
  8686.   Once upon a time, somewhere in Eastern Europe, there was a great famine.
  8687.   People jealously hoarded whatever food they could find, hiding it even
  8688.   from their friends and neighbors. One day a peddler drove his wagon into
  8689.   a village, sold a few of his wares, and began asking questions as if he
  8690.   planned to stay for the night.
  8691.  
  8692.   [No!  No!  It was three Russian Soldiers! - Lee Crocker]
  8693.   [Wait!  I heard it was a Wandering Confessor! - Doug Quinn]
  8694.   [Well *my* kids have a book that uses Russian Soldiers! - Bert]
  8695.   [Look, who's writing this documentation, anyway? - Monte]
  8696.   [Ah, but who gets it *last* and gets to upload it? - Bert]
  8697.  
  8698.   "There's not a bite to eat in the whole province," he was told. "Better
  8699.   keep moving on."
  8700.  
  8701.   "Oh, I have everything I need," he said. "In fact, I was thinking of
  8702.   making some stone soup to share with all of you." He pulled an iron
  8703.   cauldron from his wagon, filled it with water, and built a fire under
  8704.   it.  Then, with great ceremony, he drew an ordinary-looking stone from a
  8705.   velvet bag and dropped it into the water.
  8706.  
  8707.   By now, hearing the rumor of food, most of the villagers had come to the
  8708.   square or watched from their windows. As the peddler sniffed the "broth"
  8709.   and licked his lips in anticipation, hunger began to overcome their
  8710.   skepticism.
  8711.  
  8712.   "Ahh," the peddler said to himself rather loudly, "I do like a tasty
  8713.   stone soup. Of course, stone soup with CABBAGE -- that's hard to beat."
  8714.  
  8715.   Soon a villager approached hesitantly, holding a cabbage he'd retrieved
  8716.   from its hiding place, and added it to the pot. "Capital!" cried the
  8717.   peddler. "You know, I once had stone soup with cabbage and a bit of salt
  8718.   beef as well, and it was fit for a king."
  8719.  
  8720.   The village butcher managed to find some salt beef...and so it went,
  8721.   through potatoes, onions, carrots, mushrooms, and so on, until there was
  8722.   indeed a delicious meal for all. The villagers offered the peddler a
  8723.   great deal of money for the magic stone, but he refused to sell and
  8724.   traveled on the next day. And from that time on, long after the famine
  8725.   had ended, they reminisced about the finest soup they'd ever had.
  8726.  
  8727.                                   ***
  8728.  
  8729.   That's the way Fractint has grown, with quite a bit of magic, although
  8730.   without the element of deception. (You don't have to deceive programmers
  8731.   to make them think that hours of painstaking, often frustrating work is
  8732.   fun... they do it to themselves.)
  8733.  
  8734.   It wouldn't have happened, of course, without Benoit Mandelbrot and the
  8735.   explosion of interest in fractal graphics that has grown from his work
  8736.   at IBM. Or without the example of other Mandelplotters for the PC. Or
  8737.   without those wizards who first realized you could perform Mandelbrot
  8738.  
  8739.                       Fractint Version 19.2                       Page 159
  8740.  
  8741.   calculations using integer math (it wasn't us - we just recognize good
  8742.   algorithms when we steal--uhh--see them).  Or those graphics experts who
  8743.   hang around the CompuServe PICS forum and keep adding video modes to the
  8744.   program.  Or...
  8745.  
  8746.   A WORD ABOUT THE AUTHORS
  8747.  
  8748.   Fractint is the result of a synergy between the main authors, many
  8749.   contributors, and published sources.  All four of the main authors have
  8750.   had a hand in many aspects of the code.  However, each author has
  8751.   certain areas of greater contribution and creativity.  Since there is
  8752.   not room in the credits screen for the contributions of the main
  8753.   authors, we list these here to facilitate those who would like to
  8754.   communicate with us on particular subjects.
  8755.  
  8756.   Main Authors of Version 19.
  8757.  
  8758.   BERT TYLER is the original author of Fractint.  He wrote the "blindingly
  8759.   fast" 386-specific 32 bit integer math code and the original video mode
  8760.   logic. Bert made Stone Soup possible, and provides a sense of direction
  8761.   when we need it. His forte is writing fast 80x86 assembler, his
  8762.   knowledge of a variety of video hardware, and his skill at hacking up
  8763.   the code we send him!
  8764.  
  8765.   Bert has a BA in mathematics from Cornell University.  He has been in
  8766.   programming since he got a job at the computer center in his sophomore
  8767.   year at college - in other words, he hasn't done an honest day's work in
  8768.   his life.  He has been known to pass himself off as a PC expert, a UNIX
  8769.   expert, a statistician, and even a financial modeling expert.  He is
  8770.   currently masquerading as an independent PC consultant, supporting the
  8771.   PC-to-Mainframe communications environment at NIH.  If you sent mail
  8772.   from the Internet to an NIH staffer on his 3+Mail system, it was
  8773.   probably Bert's code that mangled it during the Internet-to-3+Mail
  8774.   conversion.  He also claims to support the MS-Kermit environment at NIH.
  8775.   Fractint is Bert's first effort at building a graphics program.
  8776.  
  8777.   TIM WEGNER contributed the original implementation of palette animation,
  8778.   and is responsible for most of the 3D mechanisms.  He provided the main
  8779.   outlines of the "StandardFractal" engine and data structures, and is
  8780.   accused by his cohorts of being "obsessed with options". One of Tim's
  8781.   main interests is the use of four dimensional algebras to produce
  8782.   fractals.  Tim served as team coordinator for version 19, and integrated
  8783.   Wes Loewer's arbitrary precision library into Fractint.
  8784.  
  8785.   Tim has BA and MA degrees in mathematics from Carleton College and the
  8786.   University of California Berkeley.  He worked for 7 years overseas as a
  8787.   volunteer, doing things like working with Egyptian villagers building
  8788.   water systems. Since returning to the US in 1982, he has written shuttle
  8789.   navigation software, a software support environment prototype, and
  8790.   supported strategic information planning, all at NASA's Johnson Space
  8791.   Center. Tim has started his own business, and now writes and programs
  8792.   full time.
  8793.  
  8794.   JONATHAN OSUCH started throwing pebbles into the soup around version
  8795.   15.0 with a method for simulating an if-then-else structure using the
  8796.   formula parser.  He has contributed the fn||fn fractal types, the built-
  8797.  
  8798.                       Fractint Version 19.2                       Page 160
  8799.  
  8800.   in bailout tests, the increase in both the maximum iteration count and
  8801.   bailout value, and bug fixes too numerous to count. Jonathan worked
  8802.   closely with Robin Bussell to implement Robin's browser mechanism in
  8803.   Fractint.
  8804.  
  8805.   Jonathan has a B.S. in Physics from the University of Dubuque and a B.S.
  8806.   in Computer Science from Mount Mercy College, both in Iowa.  He is
  8807.   currently working as a consultant in the nuclear power industry.
  8808.  
  8809.   WES LOEWER first got his foot in the Stone Soup door by writing fast
  8810.   floating point assembler routines for Mandelbrot, Julia, and Lyapunov
  8811.   fractals.  He also rewrote the boundary trace algorithms and added the
  8812.   frothybasin fractal.  His most significant contribution is the addition
  8813.   of the arbitrary precision library which allows Fractint to perform
  8814.   incredibly deep zooms.
  8815.  
  8816.   Wes has a B.S. in Physics from Wheaton College in Illinois.  He also
  8817.   holds an M.S. in Physics and an M.Ed. in Education from Texas A&M
  8818.   University.  Wes teaches physics and math at McCullough High School in
  8819.   The Woodlands, Texas where his pupils inspire him to keep that sense of
  8820.   amazement that students get when they understand a physical or
  8821.   mathematical principle for the first time.  Since he uses Fractint to
  8822.   help teach certain mathematical principles, he's one of the few folks
  8823.   who actually gets to use Fractint on the job.  Besides his involvement
  8824.   with Fractint, Wes is the author of WL-Plot, an equation graphing
  8825.   program, and MatCalc, a matrix calculator program.
  8826.  
  8827.   DISTRIBUTION OF FRACTINT
  8828.  
  8829.   New versions of FRACTINT are uploaded to the CompuServe network, and
  8830.   make their way to other systems from that point.  FRACTINT is available
  8831.   as two self-extracting archive files - FRAINT.EXE (executable &
  8832.   documentation) and FRASRC.EXE (source code).
  8833.  
  8834.   The latest version can always be found in one of CompuServe's GO
  8835.   GRAPHICS forums. Alas, the GO GRAPHICS Group is growing so fast that we
  8836.   get moved around from periodically, and rumor has it that yet another
  8837.   move is imminent.  The current location of Fractint is the "Fractal
  8838.   Sources" library of the GO GRAPHDEV forum. The forum staff will leave
  8839.   pointers to our new home if we are moved again.
  8840.  
  8841.   If you're not a CompuServe subscriber, but wish to get more information
  8842.   about CompuServe and its graphics forums, feel free to call their 800
  8843.   number (800-848-8199) and ask for operator number 229.
  8844.  
  8845.   If you don't have access to CompuServe, many other sites tend to carry
  8846.   these files shortly after their initial release (although sometimes
  8847.   using different naming conventions).  For instance...
  8848.  
  8849.   If you speak Internet and FTP, SIMTEL20 and its various mirror sites
  8850.   tend to carry new versions of Fractint shortly after they are released.
  8851.   look in the /SimTel/msdos/graphics directory for files named FRA*.*.
  8852.   Then again, if you don't speak Internet and FTP...
  8853.  
  8854.                       Fractint Version 19.2                       Page 161
  8855.  
  8856.   Your favorite local BBS probably carries these files as well (although
  8857.   perhaps not the latest versions) using naming conventions like FRA*.ZIP.
  8858.   One BBS that *does* carry the latest version is the "Ideal Studies BBS"
  8859.   (508)757-1806, 1200/2400/9600HST.  Peter Longo is the SYSOP and a true
  8860.   fractal fanatic.  There is a very short registration, and thereafter the
  8861.   entire board is open to callers on the first call.  Then again, if you
  8862.   don't even have a modem...
  8863.  
  8864.   Many Shareware/Freeware library services will ship you diskettes
  8865.   containing the latest versions of Fractint for a nominal fee that
  8866.   basically covers their cost of packaging and a small profit that we
  8867.   don't mind them making.  One in particular is the Public (Software)
  8868.   Library, PO Box 35705, Houston, TX 77235-5705, USA.  Their phone number
  8869.   is 800-242-4775 (outside the US, dial 713-524-6394).  Ask for item #9112
  8870.   for five 5.25" disks, #9113 for three 3.5" disks.  Cost is $6.99 plus $4
  8871.   S&H in the U.S./Canada, $11 S&H overseas.
  8872.  
  8873.   In Europe, the latest versions are available from another Fractint
  8874.   enthusiast, Jon Horner - Editor of FRAC'Cetera, a disk-based
  8875.   fractal/chaos resource.  Disk prices for UK/Europe are: 5.25" HD
  8876.   BP4.00/4.50  : 3.5" HD BP (British Pounds) 4.00/4.50.  Prices include
  8877.   p&p (airmail to Europe).  Contact: Jon Horner, FRAC'Cetera, Le Mont
  8878.   Ardaine, Rue des Ardaines, St. Peters, Guernsey GY7 9EU, CI, UK.  Phone
  8879.   (44) 01481 63689.  CIS 100112,1700
  8880.  
  8881.   The X Windows port of Fractint maintained by Ken Shirriff is available
  8882.   via FTP from sprite.berkeley.edu.
  8883.  
  8884.   CONTACTING THE AUTHORS
  8885.   Communication between the authors for development of the next version of
  8886.   Fractint takes place in a CompuServe (CIS) GO GRAPHICS GROUP (GGG)
  8887.   forum.  This forum changes from time to time as as the GGG grows. You
  8888.   can always find it using the CompuServe GO GRAPHICS command. Currently
  8889.   we are located in GRAPHDEV (Graphics Developers) forum, Section 4
  8890.   (Fractal Sources).
  8891.  
  8892.   Most of the authors have never met except on CompuServe. Access to the
  8893.   GRAPHDEV forum is open to any and all interested in computer generated
  8894.   fractals. New members are always welcome! Stop on by if you have any
  8895.   questions or just want to take a peek at what's getting tossed into the
  8896.   soup.  This is by far the best way to have your questions answered or
  8897.   participate in discussion. Also, you'll find many GIF image files
  8898.   generated by fellow Fractint fans and many fractal programs as well in
  8899.   the GRAPHDEV forum's data library 5.
  8900.  
  8901.   If you're not a CompuServe subscriber, but wish to get more information
  8902.   about CompuServe and its graphics forums, feel free to call their 800
  8903.   number (800-848-8199) and ask for operator number 229.
  8904.  
  8905.   The following authors have agreed to the distribution of their
  8906.   addresses.  Usenet/Internet/Bitnet/Whatevernet users can reach CIS users
  8907.   directly if they know the user ID (i.e., Bert Tyler's ID is
  8908.   73477.433@compuserve.com).
  8909.  
  8910.                       Fractint Version 19.2                       Page 162
  8911.  
  8912.   Just remember that CIS charges by the minute, so it costs us a little
  8913.   bit to read a message -- don't kill us with kindness. And don't send all
  8914.   your mail to Bert -- spread it around a little! Postal addresses are
  8915.   listed below so that you have a way to send bug reports and ideas to the
  8916.   Stone Soup team.
  8917.  
  8918.   Please understand that we receive a lot of mail, and because of the
  8919.   demands of volunteer work on Fractint as well as our professional
  8920.   responsibilities, we are generally unable to answer it all.  Several of
  8921.   us have reached the point where we can't answer any conventional mail.
  8922.   We *do* read and enjoy all the mail we receive, however. If you need a
  8923.   reply, the best thing to do is use email, which we are generally able to
  8924.   answer, or better yet, leave a message in CompuServe's GRAPHDEV.
  8925.  
  8926.   (This address list is getting seriously out of date. We have updated
  8927.   information from those folks who have contacted us. The next release of
  8928.   Fractint will contain the addresses of *only* those people who have
  8929.   explicitly told us that their address is correct and they want it
  8930.   listed. Please contact one of the main authors with this information.)
  8931.  
  8932.  
  8933.                       Fractint Version 19.2                       Page 163
  8934.  
  8935.   Current main authors:
  8936.  
  8937.   Bert Tyler              [73477,433] on CIS
  8938.   Tyler Software          (which is also 73477.433@compuserve.com, if
  8939.   124 Wooded Lane          you're on the Internet - see above)
  8940.   Villanova, PA 19085
  8941.   (610) 525-5478
  8942.  
  8943.   Timothy Wegner          [71320,675] on CIS
  8944.   4714 Rockwood           twegner@phoenix.net (Internet)
  8945.   Houston, TX 77004
  8946.   (713) 747-7543
  8947.  
  8948.   Jonathan Osuch          [73277,1432] on CIS
  8949.   2110 Northview Drive
  8950.   Marion, IA  52302
  8951.  
  8952.   Wesley Loewer           loewer@tenet.edu on INTERNET
  8953.   78 S. Circlewood Glen
  8954.   The Woodlands, TX  77381
  8955.   (713) 292-3449
  8956.  
  8957.   Contributing authors' addresses (in alphabetic order).
  8958.  
  8959.   Joseph A Albrecht
  8960.   9250 Old Cedar Ave #215
  8961.   Bloomington, Mn 55425
  8962.   (612) 884-3286
  8963.  
  8964.   Kevin C Allen           kevina@microsoft.com on Internet
  8965.   9 Bowen Place
  8966.   Seven Hills
  8967.   NSW 2147
  8968.   Australia
  8969.   +61-2-870-2297 (Work)
  8970.   (02) 831-4821 (Home)
  8971.  
  8972.   Rob Beyer               [71021,2074] on CIS
  8973.   23 Briarwood Lane
  8974.   Laguna Hills, CA, 92656
  8975.   (714) 957-0227
  8976.   (7-12pm PST & weekends)
  8977.  
  8978.   John W. Bridges         (Author GRASP/Pictor, Imagetools, PICEM, VGAKIT)
  8979.   2810 Serang Place Costa Mesa
  8980.   California 92626-4827   [75300,2137] on CIS, GENIE:JBRIDGES
  8981.  
  8982.   Juan J Buhler           jbuhler@usina.org.ar
  8983.   Santa Fe 2227 1P "E"
  8984.   (54-1) 84 3528
  8985.   Buenos Aires, Argentina
  8986.  
  8987.   Michael D. Burkey       burkey@sun9.math.utk.edu on Internet
  8988.   6600 Crossgate Rd.
  8989.   Knoxville, TN 37912
  8990.  
  8991.                       Fractint Version 19.2                       Page 164
  8992.  
  8993.   Robin Bussell
  8994.   13 Bayswater Rd
  8995.   Horfield
  8996.   Bristol
  8997.   Avon, England
  8998.   (044)-0272-514451
  8999.  
  9000.   Prof Jm Collard-Richard jmc@math.ethz.ch
  9001.  
  9002.   Monte Davis             [71450,3542] on CIS
  9003.   223 Vose Avenue
  9004.   South Orange, NJ 07079
  9005.   (201) 378-3327
  9006.  
  9007.   Paul de Leeuw
  9008.   50 Henry Street
  9009.   Five Dock
  9010.   New South Wales
  9011.   2046
  9012.   Australia
  9013.   +61-2-396-2246 (Work)
  9014.   +61-2-713-6064 (Home)
  9015.  
  9016.   David Guenther          [70531,3525] on CIS
  9017.   50 Rockview Drive
  9018.   Irvine, CA 92715
  9019.  
  9020.   Michael L. Kaufman      kaufman@eecs.nwu.edu on INTERNET
  9021.   2247 Ridge Ave, #2K     (also accessible via EXEC-PC bbs)
  9022.   Evanston, IL, 60201
  9023.   (708) 864-7916
  9024.   Joe McLain              [75066,1257] on CIS
  9025.   McLain Imaging
  9026.   2417 Venier
  9027.   Costa Mesa, CA 92627
  9028.   (714) 642-5219
  9029.  
  9030.   Bob Montgomery          [73357,3140] on CIS
  9031.   (Author of VPIC)
  9032.   132 Parsons Road
  9033.   Longwood, Fl  32779
  9034.  
  9035.   Roy Murphy              [76376,721] on CIS
  9036.   9050 Ewing Ave.
  9037.   Evanston, IL 60203
  9038.  
  9039.   Ethan Nagel             [71062,3677] on CIS
  9040.   4209 San Pedro NE #308
  9041.   Albuquerque, NM 87109
  9042.   (505) 884-7442
  9043.   Mark Peterson           [73642,1775] on CIS
  9044.   The Yankee Programmer
  9045.   405-C Queen St., Suite #181
  9046.   Southington, CT 06489
  9047.   (203) 276-9721
  9048.  
  9049.                       Fractint Version 19.2                       Page 165
  9050.  
  9051.   Marc Reinig             [72410,77] on CIS
  9052.   3415 Merrill Rd.        72410.77@compuserve.com.
  9053.   Aptos, CA. 95003
  9054.   (408) 475-2132
  9055.  
  9056.   Lee H. Skinner          [75450,3631] on CIS
  9057.   P.O. Box 14944
  9058.   Albuquerque, NM  87191
  9059.   (505) 293-5723
  9060.  
  9061.   Dean Souleles           [75115,1671] on CIS
  9062.   8840 Collett Ave.
  9063.   Sepulveda, CA  91343
  9064.   (818) 893-7558
  9065.  
  9066.   Chris J Lusby Taylor
  9067.   32 Turnpike Road
  9068.   Newbury, England
  9069.   Tel 011 44 635 33270
  9070.  
  9071.   Scott Taylor                  [72401,410] on CIS
  9072.   2913 Somerville Drive Apt #1  scott@bohemia.metronet.org on Internet
  9073.   Ft. Collins, Co  80526        DGWM18A on Prodigy
  9074.   (303) 221-1206
  9075.  
  9076.   Paul Varner             [73237,441] on CIS
  9077.   PO Box 930
  9078.   Shepherdstown, WV 25443
  9079.   (304) 876-2011
  9080.  
  9081.   Phil Wilson             [76247,3145] on CIS
  9082.   410 State St., #55
  9083.   Brooklyn, NY 11217
  9084.   (718) 624-5272
  9085.  
  9086.                       Fractint Version 19.2                       Page 166
  9087.  
  9088.  Appendix C GIF Save File Format
  9089.  
  9090.   Since version 5.0, Fractint has had the <S>ave-to-disk command, which
  9091.   stores screen images in the extremely compact, flexible .GIF (Graphics
  9092.   Interchange Format) widely supported on CompuServe. Version 7.0 added
  9093.   the <R>estore-from-disk capability.
  9094.  
  9095.   Until version 14, Fractint saved images as .FRA files, which were a non-
  9096.   standard extension of the then-current GIF87a specification.  The reason
  9097.   was that GIF87a did not offer a place to store the extra information
  9098.   needed by Fractint to implement the <R> feature -- i.e., the parameters
  9099.   that let you keep zooming, etc.  as if the restored file had just been
  9100.   created in this session.  The .FRA format worked with all of the popular
  9101.   GIF decoders that we tested, but these were not true GIF files. For one
  9102.   thing, information after the GIF terminator (which is where we put the
  9103.   extra info) has the potential to confuse the online GIF viewers used on
  9104.   CompuServe. For another, it is the opinion of some GIF developers that
  9105.   the addition of this extra information violates the GIF87a spec. That's
  9106.   why we used the default filetype .FRA instead.
  9107.  
  9108.   Since version 14, Fractint has used a genuine .GIF format, using the
  9109.   GIF89a spec - an upwardly compatible extension of GIF87a, released by
  9110.   CompuServe on August 1 1990.  This new spec allows the placement of
  9111.   application data within "extension blocks".  In version 14 we changed
  9112.   our default savename extension from .FRA to .GIF.
  9113.  
  9114.   There is one significant advantage to the new GIF89a format compared to
  9115.   the old GIF87a-based .FRA format for Fractint purposes:  the new .GIF
  9116.   files may be uploaded to the CompuServe graphics forums fractal
  9117.   information intact.  Therefore anyone downloading a Fractint image from
  9118.   CompuServe will also be downloading all the information needed to
  9119.   regenerate the image.
  9120.  
  9121.   Fractint can still read .FRA files generated by earlier versions.  If
  9122.   for some reason you wish to save files in the older GIF87a format, for
  9123.   example because your favorite GIF decoder has not yet been upgraded to
  9124.   GIF89a, use the command-line parameter "GIF87a=yes".  Then any saved
  9125.   files will use the original GIF87a format without any application-
  9126.   specific information.
  9127.  
  9128.   An easy way to convert an older .FRA file into true .GIF format suitable
  9129.   for uploading is something like this at the DOS prompt:
  9130.       FRACTINT MYFILE.FRA SAVENAME=MYFILE.GIF BATCH=YES
  9131.   Fractint will load MYFILE.FRA, save it in true .GIF format as
  9132.   MYFILE.GIF, and return to DOS.
  9133.  
  9134.   GIF and "Graphics Interchange Format" are trademarks of CompuServe
  9135.   Incorporated, an H&R Block Company.
  9136.  
  9137.                       Fractint Version 19.2                       Page 167
  9138.  
  9139.  Appendix D Other Fractal Products
  9140.  
  9141.   (Forgive us, but we just *have* to begin this section with a plug for
  9142.   *our* fractal products...)
  9143.  
  9144.   Several of Fractint's programmers have written books about fractals,
  9145.   Fractint, and Winfract (the Windows version of Fractint).  The book
  9146.   about Fractint is Fractal Creations Second Edition (1994 Waite Group
  9147.   Press, ISBN # 1-878739-34-4).  The book about Winfract is The Waite
  9148.   Group's Fractals for Windows (1992 Waite Group Press, ISBN # 1-878739-
  9149.   25-5).
  9150.  
  9151.   Fractal Creations Second Edition includes:
  9152.    o A guided tour of Fractint.
  9153.    o A detailed manual and reference section of commands.
  9154.    o A tutorial on fractals.
  9155.    o A reference containing tips, explanations, and examples of parameters
  9156.      for all the Fractals generated by Fractint/Winfract.
  9157.    o Secrets on how the programs work internally.
  9158.    o Spectacular color plate section.
  9159.    o A CD containing Fractint and Xfract source and executable, and over a
  9160.      thousand spectacular fractal images.
  9161.    o A complete copy of the source code with a chapter explaining how the
  9162.      program works.
  9163.  
  9164.   If you enjoy Fractint, you're sure to enjoy Fractal Creations. The book
  9165.   includes Fractint and is an excellent companion to the program.  If you
  9166.   use the Windows environment, be sure to pick up a copy of Fractals for
  9167.   Windows as well.
  9168.  
  9169.   A great fractals newsletter is "Amygdala" published by Rollo Silver.
  9170.   You'll find equal parts fractal algorithms, humor, reviews, and ideas.
  9171.   Write to:
  9172.      Amygdala
  9173.      Box 219
  9174.      San Cristobal, NM 87564
  9175.      USA
  9176.      Email:rsilver@lanl.gov
  9177.      Phone: 505-586-0197
  9178.  
  9179.   Another great fractals newsletter (this one based in the UK) is
  9180.   "FRAC'Cetera", a disk-based fractal/chaos resource, for PCs and
  9181.   compatibles, distributed on 3.5" HD disk, published by Jon Horner.
  9182.   Contact:
  9183.  
  9184.      Jon Horner
  9185.      FRAC'Cetera
  9186.      Le Mont Ardaine
  9187.      Rue des Ardaines
  9188.      ST Peters
  9189.      Guernsey GY7 9EU, CI, UK
  9190.      Email: 100112.1700@compuserve.com
  9191.      PH: (44) 01481 63689
  9192.  
  9193.                       Fractint Version 19.2                       Page 168
  9194.  
  9195.   Several Fractint enthusiasts are selling Fractal CDs.  Two of the best
  9196.   are called "Fractal Frenzy" by Lee Skinner, and "Fractography" by Caren
  9197.   Park.  Highly recommended original artwork in a variety of graphics
  9198.   formats.
  9199.  
  9200.   You can receive the "Fractal Frenzy CD" by sending $39.95US + $5.00 S&H
  9201.      to Walnut Creek CDROM
  9202.      1537 Palos Verdes Mall, Suite 260
  9203.      Walnut Creek, CA 94596
  9204.  
  9205.   and the "Fractography" CD by sending $30.00US + $5.00 S&H (in US/Canada)
  9206.   to
  9207.      Lost and Found Books
  9208.      485 Front Street N, Suite A
  9209.      Issaquah, WA 98027-2900
  9210.  
  9211.   Michael Peters (author of PARTOBAT) and Randall Scott have written a
  9212.   fractal program called HOP based on the Martin orbit fractals. This
  9213.   program is much narrower than Fractint in the kind of thing that it
  9214.   does, but has many more animation effects and makes a great screen
  9215.   saver. Michael sent us the algorithms for the chip, quadruptwo, and
  9216.   threeply fractal types to give us a taste. The file is called HOPZIP.EXE
  9217.   in LIB 4 of CompuServe's GRAPHDEV forum.
  9218.  
  9219.                       Fractint Version 19.2                       Page 169
  9220.  
  9221.  Appendix E Bibliography
  9222.  
  9223.   BARNSLEY, Michael: "Fractals Everywhere," Academic Press, 1988.
  9224.  
  9225.   DAVENPORT, Clyde: "A Hypercomplex Calculus with Applications to
  9226.      Relativity", ISBN 0-9623837-0-8. This self-published expansion of Mr.
  9227.      Davenport's Master's thesis makes the case for using hypercomplex
  9228.      numbers rather than quaternions. This book provided the background
  9229.      for Fractint's implementation of hypercomplex fractals.
  9230.  
  9231.   DEWDNEY, A. K., "Computer Recreations" columns in "Scientific American"
  9232.      -- 8/85, 7/87, 11/87, 12/88, 7/89.
  9233.  
  9234.   FEDER, Jens: "Fractals," Plenum, 1988.
  9235.      Quite technical, with good coverage of applications in fluid
  9236.      percolation, game theory, and other areas.
  9237.  
  9238.   GLEICK, James: "Chaos: Making a New Science," Viking Press, 1987.
  9239.      The best non-technical account of the revolution in our understanding
  9240.      of dynamical systems and its connections with fractal geometry.
  9241.  
  9242.   MANDELBROT, Benoit: "The Fractal Geometry of Nature," W. H. Freeman &
  9243.      Co., 1982.
  9244.      An even more revised and expanded version of the 1977 work. A rich
  9245.      and sometimes confusing stew of formal and informal mathematics, the
  9246.      prehistory of fractal geometry, and everything else. Best taken in
  9247.      small doses.
  9248.  
  9249.   MANDELBROT, Benoit: "Fractals: Form, Chance, and Dimension," W. H.
  9250.      Freeman & Co., 1977.
  9251.      A much revised translation of "Les objets fractals: forme, hasard, et
  9252.      dimension," Flammarion, 1975.
  9253.  
  9254.   PEITGEN, Heinz-Otto & RICHTER, Peter: "The Beauty of Fractals,"
  9255.      Springer-Verlag, 1986.
  9256.      THE coffee-table book of fractal images, knowledgeable on computer
  9257.      graphics as well as the mathematics they portray.
  9258.  
  9259.   PEITGEN, Heinz-Otto & SAUPE, Ditmar: "The Science of Fractal Images,"
  9260.      Springer-Verlag, 1988.
  9261.      A fantastic work, with a few nice pictures, but mostly filled with
  9262.      *equations*!!!
  9263.  
  9264.   PICKOVER, Clifford: "Computers, Pattern, Chaos, and Beauty," St.
  9265.      Martin's Press, 1990.
  9266.  
  9267.   SCHROEDER, Manfred: "Fractals, Chaos, Power Laws," W. H. Freeman & Co.,
  9268.      1991.
  9269.  
  9270.   WEGNER, Timothy: "Image Lab, Second Edition", Waite Group Press, to be
  9271.      released in 1995. Learn how to create fractal animations, fractal RDS
  9272.      stereo images, and how to use Fractint with other image creation and
  9273.      processing tools such as Piclab, POV-Ray and Polyray ray tracers.
  9274.  
  9275.                       Fractint Version 19.2                       Page 170
  9276.  
  9277.   WEGNER, Timothy & TYLER, Bert: "Fractal Creations, Second Edition" Waite
  9278.      Group Press, 1993
  9279.      This is the definitive Fractint book. Spectacular color plate
  9280.      section, totally new and expanded fractal type descriptions,
  9281.      annotated PAR files, source code secrets, and a CD filled to the brim
  9282.      with spectacular fractals.
  9283.  
  9284.   WEGNER, Timothy, TYLER, Bert, PETERSON, Mark, and Branderhorst, Pieter:
  9285.      "Fractals for Windows," Waite Group Press, 1992.
  9286.      This book is to Winfract (the Windows version of Fractint) what
  9287.      "Fractal Creations" is to Fractint.
  9288.   .
  9289.  
  9290.                       Fractint Version 19.2                       Page 171
  9291.  
  9292.  Appendix F Other Programs
  9293.  
  9294.   WINFRACT. Bert Tyler has ported Fractint to run under Windows 3!  The
  9295.   same underlying code is used, with a Windows user interface.  Winfract
  9296.   has almost all the functionality of Fractint - the biggest difference is
  9297.   the absence of a zillion weird video modes.  Fractint for DOS will
  9298.   continue to be the definitive version.  Winfract is available from
  9299.   CompuServe in GRAPHDEV Lib 4, as WINFRA.ZIP (executable) and WINSRC.ZIP
  9300.   (source).
  9301.  
  9302.  
  9303.   PICLAB, by Lee Crocker - a freeware image manipulation utility available
  9304.   from CompuServe in PICS Lib 10, as PICLAB.EXE.  PICLAB can do very
  9305.   sophisticated resizing and color manipulation of GIF and TGA files.  It
  9306.   can be used to reduce 24 bit TGA files generated with the Fractint
  9307.   "lightname" option to GIF files.
  9308.  
  9309.  
  9310.   FDESIGN, by Doug Nelson (CIS ID 70431,3374) - a freeware IFS fractal
  9311.   generator available from CompuServe in GRAPHDEV Lib 4, and probably on
  9312.   your local BBS.  This program requires a VGA adapter and a Microsoft-
  9313.   compatible mouse, and a floating point coprocessor is highly
  9314.   recommended.  It generates IFS fractals in a *much* more intuitive
  9315.   fashion than Fractint.  It can also (beginning with version 3.0) save
  9316.   its IFS formulas in Fractint-style .IFS files.
  9317.  
  9318.   ACROSPIN, by David Parker - An inexpensive commercial program that reads
  9319.   an object definition file and creates images that can be rapidly rotated
  9320.   in three dimensions. The Fractint "orbitsave=yes" option creates files
  9321.   that this program can read for orbit-type fractals and IFS fractals.
  9322.   Contact:
  9323.      David Parker                         801-966-2580
  9324.      P O Box 26871                        800-227-6248
  9325.      Salt Lake City, UT  84126-0871
  9326.  
  9327.                       Fractint Version 19.2                       Page 172
  9328.  
  9329.  Appendix G Revision History
  9330.  
  9331.   Versions 18.1 and 18.2 are bug-fix releases for version 18.0.  Changes
  9332.   from 18.1 to 18.2 include:
  9333.  
  9334.    The <b> command now causes filenames only to be written in PAR files.
  9335.  
  9336.    Fractint will now search directories in the PATH for files not found in
  9337.    the requested the requested directory or the current directory. If you
  9338.    place .MAP, .FRM, etc. in directories in your PATH, then Fractint will
  9339.    find them.
  9340.  
  9341.    Fixed bug that caused fractals using PI symmetry to fail at high
  9342.    resolution.
  9343.  
  9344.    Fractals interrupted with <3> or <r> can now resume.
  9345.  
  9346.    The palette editor's <u> (undo) now works.
  9347.  
  9348.    The <s> command in orbit/Julia window mode is no longer case sensitive.
  9349.  
  9350.    Added warnings that the POV-Ray output is obsolete (but has been left
  9351.    in).  Use POV-Ray's height field facility instead or create and convert
  9352.    RAW files.
  9353.  
  9354.    Fixed several IFS bugs.
  9355.  
  9356.   Changes from 18.0 to 18.1 include:
  9357.  
  9358.    Overlay tuning - the Mandelbrot/Julia Set fractals are now back up to
  9359.    17.x speeds
  9360.  
  9361.    Disk Video modes now work correctly with VESA video adapters (they used
  9362.    to use the same array for different purposes, confusing each other)
  9363.  
  9364.    1024x768x256 and 2048x2048x256 disk video modes work again
  9365.  
  9366.    Parameter-file processing no longer crashes Fractint if it attempts to
  9367.    run a formula requiring access to a non-existent FRM file
  9368.  
  9369.    IFS arrays no longer overrun their array space
  9370.  
  9371.    type=cellular fixes
  9372.  
  9373.    "autologmap=2" now correctly picks up the minimum color
  9374.  
  9375.    The use of disk-video mode with random-access fractal types is now
  9376.    legal (it generates a warning message but lets you proceed if you
  9377.    really want to)
  9378.  
  9379.    The Lsystems "spinning-wheel" now spins slower (removing needless
  9380.    overhead)
  9381.  
  9382.    Changes to contributors' addresses in the Help screens
  9383.  
  9384.                       Fractint Version 19.2                       Page 173
  9385.  
  9386.   (The remainder of this "new features" section is from version 18.0)
  9387.  
  9388.   New fractal types:
  9389.  
  9390.    19 new fractal types, including:
  9391.  
  9392.    New fractal types - 'lambda(fn||fn)', 'julia(fn||fn)',
  9393.    'manlam(fn||fn)', 'mandel(fn||fn)', 'halley', 'phoenix', 'mandphoenix',
  9394.    'cellular', generalized bifurcation, and 'bifmay' - from Jonathan
  9395.    Osuch.
  9396.  
  9397.    New Mandelcloud, Quaternion, Dynamic System, Cellular Automata fractal
  9398.    types from Ken Shirriff.
  9399.  
  9400.    New HyperComplex fractal types from Timothy Wegner
  9401.  
  9402.    New ICON type from Dan Farmer, including a PAR file of examples.
  9403.  
  9404.    New Frothy Basin fractal types (and PAR entries) by Wesley Loewer
  9405.  
  9406.    MIIM (Modified Inverse Iteration Method) implementation of Inverse
  9407.    Julia from Michael Snyder.
  9408.  
  9409.    New Inverse Julia fractal type from Juan Buhler.
  9410.  
  9411.    New floating-point versions of Markslambda, Marksmandel, Mandel4, and
  9412.    Julia4 types (chosen automatically if the floating-point option is
  9413.    enabled).
  9414.  
  9415.   New options/features:
  9416.  
  9417.    New assembler-based parser logic from Chuck Ebbert - significantly
  9418.    faster than the C-based code it replaces!
  9419.  
  9420.    New assembler-based Lyapunov logic from Nicholas Wilt and Wes Loewer.
  9421.    Roughly six times faster than the old version!
  9422.  
  9423.    New Orbits-on-a-window / Julia-in-a-window options:
  9424.     1) The old Overlay option is now '#' (Shift-3).
  9425.     2) During generation, 'O' brings up orbits (as before) - after
  9426.        generation, 'O' brings up new orbits Windows mode.
  9427.     3) Control-O brings up new orbits Windows mode at any time.
  9428.     4) Spacebar toggles between Inverse Julia mode and the Julia set and
  9429.        back to the Mandelbrot set.
  9430.    These new "in-a-window" modes are really neat!  See Orbits Window
  9431.    (p. 26) and Julia Toggle Spacebar Commands (p. 35) for details.
  9432.  
  9433.    New multi-image GIF support in the <B> command.  You can now generate
  9434.    65535x65535x256 fractal images using Fractint (if you have the disk
  9435.    space, of course).  This option builds special PAR entries and a
  9436.    MAKEMIG.BAT file that you later use to invoke Fractint multiple times
  9437.    to generate individual sections of the image and (in a final step)
  9438.    stitch them all together.  If your other software can't handle
  9439.    Multiple-image GIFs, a SIMPLGIF program is also supplied that converts
  9440.    MIGS into simgle-image GIFs.  Press F1 at the <B> prompts screen for
  9441.    details.
  9442.  
  9443.                       Fractint Version 19.2                       Page 174
  9444.  
  9445.    Fractint's decoder now handles Multi-Image Gifs.
  9446.  
  9447.    New SuperVGA/VESA Autodetect logic from the latest version of VGAKIT.
  9448.    Sure hope we didn't break anything.
  9449.  
  9450.    New register-compatible 8514/A code from Jonathan Osuch.  By default,
  9451.    Fractint now looks first for the presence of an 8514/A register-
  9452.    compatible adapter and then (and only if it doesn't find one) the
  9453.    presence of the 8514/A API (IE, HDILOAD is no longer necessary for
  9454.    register-compatible "8514/a" adapters).  Fractint can be forced to use
  9455.    the 8514/A API by using a new command-line option, "afi=yes".  Jonathan
  9456.    also added ATI's "8514/a-style" 800x600x256 and 1280x1024x16 modes.
  9457.  
  9458.    New XGA-detection logic for ISA-based XGA-2 systems.
  9459.  
  9460.    The palette editor now has a "freestyle" editing option.  See Palette
  9461.    Editing Commands (p. 18) for details.
  9462.  
  9463.  
  9464.    Fractint is now more "batch file" friendly.  When running Fractint from
  9465.    a batch file, pressing any key will cause Fractint to exit with an
  9466.    errorlevel = 2.  Any error that interrupts an image save to disk will
  9467.    cause an exit with errorlevel = 2.  Any error that prevents an image
  9468.    from being generated will cause an exit with errorlevel = 1.
  9469.  
  9470.    New Control-X, Control-Y, and Control-Z options flip a fractal image
  9471.    along the X-axis, Y-axis, and Origin, respectively.
  9472.  
  9473.    New area calculation mode in TAB screen from Ken Shirriff (for accuracy
  9474.    use inside=0).
  9475.  
  9476.    The TAB screen now indicates when the Integer Math algorithms are in
  9477.    use.
  9478.  
  9479.    The palette must now be explicitly changed, it will not reset to the
  9480.    default unexpectedly when doing things like switching video modes.
  9481.  
  9482.    The Julibrot type has been generalized.  Julibrot fractals can now be
  9483.    generated from PAR files.
  9484.  
  9485.    Added <b> command support for viewwindows.
  9486.  
  9487.    Added room for two additional PAR comments in the <B> command
  9488.  
  9489.    New coloring method for IFS shows which parts of fractal came from
  9490.    which transform.
  9491.  
  9492.    Added attractor basin phase plotting for Julia sets from Ken Shirriff.
  9493.  
  9494.    Improved finite attractor code to find more attractors from Ken
  9495.    Shirriff.
  9496.  
  9497.    New zero function, to be used in PAR files to replace old integer tan,
  9498.    tanh
  9499.  
  9500.                       Fractint Version 19.2                       Page 175
  9501.  
  9502.    Debugflag=10000 now reports video chipset in use as well as CPU/FPU
  9503.    type and available memory
  9504.  
  9505.    Added 6 additional parameters for params= for those fractal types that
  9506.    need them.
  9507.  
  9508.    New 'matherr()' logic lets Fractint get more aggressive when these
  9509.    errors happen.
  9510.  
  9511.    New autologmap option (log=+-2) from Robin Bussell that ensures that
  9512.    all palette values are used by searching the screen border for the
  9513.    lowest value and then setting log= to +- that color.
  9514.  
  9515.    Two new diffusion options - falling and square cavity.
  9516.  
  9517.    Three new Editpal commands: '!', '@' and '#' commands (that's <shift-
  9518.    1>, <shift-2>, and <shift-3>) to swap R<->G, G<->B, R<->B.
  9519.  
  9520.    Parameter files now use a slightly shorter maximum line length, making
  9521.    them a bit more readable when stuffed into messages on CompuServe.
  9522.  
  9523.    Plasma now has 16-bit .POT output for use with Ray tracers. The "old"
  9524.    algorithm has been modified so that the plasma effect is independent of
  9525.    resolution.
  9526.  
  9527.    Slight modification to the Raytrace code to make it compatible with
  9528.    Rayshade 4.0 patch level 6.
  9529.  
  9530.    Improved boundary-tracing logic from Wesley Loewer.
  9531.  
  9532.    Command-line parameters can now be entered on-the-fly using the <g> key
  9533.    thanks to Ken Shirriff.
  9534.  
  9535.    Dithered gif images can now be loaded onto a b/w display.  Thanks to
  9536.    Ken Shirriff.
  9537.  
  9538.    Pictures can now be output as compressed PostScript.  Thanks to Ken
  9539.    Shirriff.
  9540.  
  9541.    Periodicity is a new inside coloring option.  Thanks to Ken Shirriff.
  9542.  
  9543.    Fixes: symmetry values for the SQR functions, bailout for the floating-
  9544.    pt versions of 'lambdafn' and 'mandelfn' fractals from Jonathan Osuch.
  9545.  
  9546.    "Flip", "conj" operators are now selectable in the parser
  9547.  
  9548.    New DXF Raytracing option from Dennis Bragg.
  9549.  
  9550.    Improved boundary-tracing logic from Wesley Loewer.
  9551.  
  9552.    New MSC7-style overlay structure is used if MAKEFRAC.BAT specifies
  9553.    MSC7.  (with new FRACTINT.DEF and FRACTINT.LNK files for MSC7 users).
  9554.    Several modules have been re-organized to take advantage of this new
  9555.    overlay capability if compiled under MSC7.
  9556.  
  9557.                       Fractint Version 19.2                       Page 176
  9558.  
  9559.    Fractint now looks first any embedded help inside FRACTINT.EXE, and
  9560.    then for an external FRACTINT.HLP file before giving up. Previous
  9561.    releases required that the help text be embedded inside FRACTINT.EXE.
  9562.  
  9563.   Bug fixes:
  9564.  
  9565.    Corrected formulas displayed for Marksmandel, Cmplxmarksmandel, and
  9566.     associated julia types.
  9567.  
  9568.    BTM and precision fixes.
  9569.  
  9570.    Symmetry logic changed for various "outside=" options
  9571.  
  9572.    Symmetry value for EXP function in lambdafn and lambda(fn||fn) fixed.
  9573.  
  9574.    Fixed bug where math errors prevented save in batch mode.
  9575.  
  9576.    The <3> and <r> commands no longer destroy image -- user can back out
  9577.    with ESC and image is still there.
  9578.  
  9579.    Fixed display of correct number of Julibrot parameters, and Julibrot
  9580.    relaxes and doesn't constantly force ALTERN.MAP.
  9581.  
  9582.    Fixed tesseral type for condition when border is all one color but
  9583.    center contains image.
  9584.  
  9585.    Fixed integer mandel and julia when used with parameters > +1.99 and <
  9586.    -1.99
  9587.  
  9588.    Eliminated recalculation when generating a julia type from a mandelbrot
  9589.    type when the 'z' screen is viewed for the first time.
  9590.  
  9591.    Minor logic change to prevent double-clutching into and out of graphics
  9592.    mode when pressing, say, the 'x' key from a menu screen.
  9593.  
  9594.    Changed non-US phone number for the Houston Public (Software) Library
  9595.  
  9596.    The "Y" screen is now "Extended Options" instead of "Extended Doodads"
  9597.  
  9598.    ...and probably a lot more bux-fixes that we've since forgotten that
  9599.    we've implemented.
  9600.  
  9601.  
  9602.   Version 17.2, 3/92
  9603.  
  9604.    - Fixed a bug which caused Fractint to hang when a Continuous Potential
  9605.      Bailout value was set (using the 'Y') screen and then the 'Z' screen
  9606.      was activated.
  9607.    - fixed a bug which caused "batch=yes" runs to abort whenever any
  9608.      key was pressed.
  9609.    - bug-fixes in the Stereo3D/Targa logic from Marc Reinig.
  9610.    - Fractint now works correctly again on FPU-less 8088s when
  9611.      zoomed deeply into the Mandelbrot/Julia sets
  9612.    - The current image is no longer marked as "not resumable" on a
  9613.      Shell-To-Dos ("D") command.
  9614.    - fixed a bug which prevented the "help" functions from working
  9615.  
  9616.                       Fractint Version 19.2                       Page 177
  9617.  
  9618.      properly during fractal-type selection for some fractal types.
  9619.  
  9620.   Version 17.1, 3/92
  9621.  
  9622.    - fixed a bug which caused PCs with no FPU to lock up when they
  9623.    attempted
  9624.      to use some fractal types.
  9625.    - fixed a color-cycling bug which caused the palette to single-step
  9626.      when you pressed ESCAPE to exit color-cycling.
  9627.    - fixed the action of the '<' and '>' keys during color-cycling.
  9628.  
  9629.   Version 17.0, 2/92
  9630.  
  9631.   - New fractal types (but of course!):
  9632.  
  9633.   Lyapunov Fractals from Roy Murphy (see Lyapunov Fractals (p. 62) for
  9634.   details)
  9635.  
  9636.   'BifStewart' (Stewart Map bifurcation) fractal type and new bifurcation
  9637.   parameters (filter cycles, seed population) from Kevin Allen.
  9638.  
  9639.   Lorenz3d1, Lorenz3d3, and Lorenz3d4 fractal types from Scott Taylor.
  9640.   Note that a bug in the Lorenz3d1 fractal prevents zooming-out from
  9641.   working with it at the moment.
  9642.  
  9643.   Martin, Circle, and Hopalong (culled from Dewdney's Scientific American
  9644.   Article)
  9645.  
  9646.   Lots of new entries in fractint.par.
  9647.  
  9648.   New ".L" files (TILING.L, PENROSE.L)
  9649.  
  9650.   New 'rand()' function added to the 'type=formula' parser
  9651.  
  9652.   - New fractal generation options:
  9653.  
  9654.   New 'Tesseral' calculation algorithm (use the 'X' option list to select
  9655.   it) from  Chris Lusby Taylor.
  9656.  
  9657.   New 'Fillcolor=' option shows off Boundary Tracing and Tesseral
  9658.   structure
  9659.  
  9660.   inside=epscross and inside=startrail options taken from a paper by
  9661.   Kenneth Hooper, with credit also to Clifford Pickover
  9662.  
  9663.   New Color Postscript Printer support from Scott Taylor.
  9664.  
  9665.   Sound= command now works with <O>rbits and <R>ead commands.
  9666.  
  9667.   New 'orbitdelay' option in X-screen and command-line interface
  9668.  
  9669.   New "showdot=nn" command-line option that displays the pixel currently
  9670.   being worked on using the specified color value (useful for those
  9671.   lloooonngg images being calculated using solid guessing - "where is it
  9672.   now?").
  9673.  
  9674.                       Fractint Version 19.2                       Page 178
  9675.  
  9676.   New 'exitnoask=yes' commandline/SSTOOLS.INI option to avoid the final
  9677.   "are you sure?" screen
  9678.  
  9679.   New plasma-cloud options.  The interface at the moment (documented here
  9680.     and here only because it might change later) lets you:
  9681.     - use an alternate drawing algorithm that gives you an earlier preview
  9682.       of the finished image.  - re-generate your favorite plasma cloud
  9683.     (say, at a higher resolution)
  9684.       by forcing a re-select of the random seed.
  9685.  
  9686.   New 'N' (negative palette) option from Scott Taylor - the documentation
  9687.   at this point is:  Pressing 'N' while in the palette editor will invert
  9688.   each color. It will convert only the current color if it is in 'x' mode,
  9689.   a range if in 'y' mode, and every color if not in either the 'x' or 'y'
  9690.   mode.
  9691.  
  9692.   - Speedups:
  9693.  
  9694.   New, faster floating-point Mandelbrot/Julia set code from Wesley Loewer,
  9695.   Frank Fussenegger and Chris Lusby Taylor (in separate contributions).
  9696.  
  9697.   Faster non-386 integer Mandelbrot code from Chris Lusby Taylor, Mike
  9698.   Gelvin and Bill Townsend (in separate contributions)
  9699.  
  9700.   New integer Lsystems logic from Nicholas Wilt
  9701.  
  9702.   Finite-Attractor fixups and Lambda/mandellambda speedups from Kevin
  9703.   Allen.
  9704.  
  9705.   GIF Decoder speedups from Mike Gelvin
  9706.  
  9707.   - Bug-fixes and other enhancements:
  9708.  
  9709.   Fractint now works with 8088-based AMSTRAD computers.
  9710.  
  9711.   The video logic is improved so that (we think) fewer video boards will
  9712.   need "textsafe=save" for correct operation.
  9713.  
  9714.   Fixed a bug in the VESA interface which effectively messed up adapters
  9715.   with unusual VESA-style access, such as STB's S3 chipset.
  9716.  
  9717.   Fixed a color-cycling bug that would at times restore the wrong colors
  9718.   to your image if you exited out of color-cycling, displayed a 'help'
  9719.   screen, and then returned to the image.
  9720.  
  9721.   Fixed the XGA video logic so that its 256-color modes use the same
  9722.   default 256 colors as the VGA adapter's 320x200x256 mode.
  9723.  
  9724.   Fixed the 3D bug that caused bright spots on surfaces to show as black
  9725.   blotches of color 0 when using a light source.
  9726.  
  9727.   Fixed an image-generation bug that sometimes caused image regeneration
  9728.   to restart even if not required if the image had been zoomed in to the
  9729.   point that floating-point had been automatically activated.
  9730.  
  9731.                       Fractint Version 19.2                       Page 179
  9732.  
  9733.   Added autodetection and 640x480x256 support for the Compaq Advanced VGA
  9734.   Systems board - I wonder if it works?
  9735.  
  9736.   Added VGA register-compatible 320x240x256 video mode.
  9737.  
  9738.   Fixed the "logmap=yes" option to (again) take effect for continuous
  9739.   potential images.  This was broken in version 15.x.
  9740.  
  9741.   The colors for the floating-point algorithm of the Julia fractal now
  9742.   match the colors for the integer algorithm.
  9743.  
  9744.   If the GIF Encoder (the "Save" command) runs out of disk space, it now
  9745.   tells you about it.
  9746.  
  9747.   If you select both the boundary-tracing algorithm and either "inside=0"
  9748.   or "outside=0", the algorithm will now give you an error message instead
  9749.   of silently failing.
  9750.  
  9751.   Updated 3D logic from Marc Reinig.
  9752.  
  9753.   Minor changes to permit IFS3D fractal types to be handled properly using
  9754.   the "B" command.
  9755.  
  9756.   Minor changes to the "Obtaining the latest Source" section to refer to
  9757.   BBS access (Peter Longo's) and mailed diskettes (the Public (Software)
  9758.   Library).
  9759.  
  9760.  
  9761.   Version 16.12, 8/91
  9762.  
  9763.     Fix to cure some video problems reported with Amstrad 8088/8086-based
  9764.        PCs.
  9765.  
  9766.   Version 16.11, 7/91
  9767.  
  9768.     SuperVGA Autodetect fixed for older Tseng 3000 adapters.
  9769.  
  9770.     New "adapter=" options to force the selection of specific SuperVGA
  9771.        adapter types.  See Video Parameters (p. 111) for details.
  9772.  
  9773.     Integer/Floating-Point math toggle is changed only temporarily if
  9774.        floating-point math is forced due to deep zooming.
  9775.  
  9776.     Fractint now survives being modified by McAfee's "SCAN /AV" option.
  9777.  
  9778.     Bug Fixes for Acrospin interface, 3D "Light Source Before
  9779.        Transformation" fill type, and GIF decoder.
  9780.  
  9781.     New options in the <Z> parameters screen allow you to directly enter
  9782.        image coordinates.
  9783.  
  9784.     New "inside=zmag" and "outside=real|imag|mult|summ" options.
  9785.  
  9786.     The GIF Decoder now survives reading GIF files with a local color map.
  9787.     Improved IIT Math Coprocessor support.
  9788.  
  9789.                       Fractint Version 19.2                       Page 180
  9790.  
  9791.     New color-cycling single-step options, '<' and '>'.
  9792.  
  9793.   Version 16.0, 6/91
  9794.  
  9795.     Integrated online help / fractint.doc system from Ethan Nagel.  To
  9796.       create a printable fractint.doc file see Startup Parameters (p. 101)
  9797.       .
  9798.  
  9799.     Over 350 screens of online help! Try pressing <F1> just about
  9800.     anywhere!
  9801.  
  9802.     New "autokey" feature.  Type "demo" to run the included demo.bat and
  9803.       demo.key files for a great demonstration of Fractint.  See Autokey
  9804.       Mode (p. 72) for details.
  9805.  
  9806.     New <@> command executes a saved set of commands.  The <b> command has
  9807.       changed to write the current image's parameters as a named set of
  9808.       commands in a structured file.  Saved sets of commands can
  9809.       subsequently be executed with the <@> command.  See Parameter
  9810.       Save/Restore Commands (p. 23).  A default "fractint.par" file is
  9811.       included with the release.
  9812.  
  9813.     New <z> command allows changing fractal type-specific parameters
  9814.       without going back through the <t> (fractal type selection) screen.
  9815.  
  9816.     Ray tracer interface from Marc Reinig, generates 3d transform output
  9817.       for a number of ray tracers; see "Interfacing with Ray Tracing
  9818.       Programs" (p. 96)
  9819.  
  9820.     Selection of video modes and structure of "fractint.cfg" have changed.
  9821.       If you have a customized fractint.cfg file, you'll have to rebuild
  9822.       it based on this release's version. You can customize the assignment
  9823.       of your favorite video modes to function keys; see Video Mode
  9824.       Function Keys (p. 28).  <delete> is a new command key which goes
  9825.       directly to video mode selection.
  9826.  
  9827.     New "cyclerange" option (command line and <y> options screen) from
  9828.       Hugh Steele. Limits color cycling to a specified range of colors.
  9829.  
  9830.     Improved Distance Estimator Method (p. 74) algorithm from Phil
  9831.     Wilson.
  9832.  
  9833.     New "ranges=" option from Norman Hills.  See Logarithmic Palettes and
  9834.       Color Ranges (p. 77) for details.
  9835.  
  9836.     type=formula definitions can use "variable functions" to select sin,
  9837.       cos, sinh, cosh, exp, log, etc at run time; new built-ins tan, tanh,
  9838.       cotan, cotanh, and flip are available with type=formula; see Type
  9839.       Formula (p. 55)
  9840.  
  9841.     New <w> command in palette editing mode to convert image to greyscale
  9842.  
  9843.     All "fn" fractal types (e.g. fn*fn) can now use new functions tan,
  9844.       tanh, cotan, cotanh, recip, and ident; bug in prior cos function
  9845.       fixed, new function cosxx (conjugate of cos) is the old erroneous
  9846.       cos calculation
  9847.  
  9848.                       Fractint Version 19.2                       Page 181
  9849.  
  9850.     New L-Systems from Herb Savage
  9851.     New IFS types from Alex Matulich
  9852.     Many new formulas in fractint.frm, including a large group from JM
  9853.       Collard-Richard
  9854.     Generalized type manzpwr with complex exponent per Lee Skinner's
  9855.     request
  9856.     Initial orbit parameter added to Gingerbreadman fractal type
  9857.  
  9858.     New color maps (neon, royal, volcano, blues, headache) from Daniel
  9859.     Egnor
  9860.  
  9861.     IFS type has changed to use a single file containing named entries
  9862.       (instead of a separate xxx.ifs file per type); the <z> command
  9863.       brings up IFS editor (used to be <i> command).  See Barnsley IFS
  9864.       Fractals (p. 43).
  9865.  
  9866.     Much improved support for PaintJet printers; see PaintJet Parameters
  9867.     (p. 117)
  9868.  
  9869.     From Scott Taylor:
  9870.       Support for plotters using HP-GL; see Plotter Parameters (p. 118)
  9871.       Lots of new PostScript halftones; see PostScript Parameters (p. 115)
  9872.       "printer=PS[L]/0/..." for full page PostScript; see PostScript
  9873.       Parameters (p. 115)
  9874.       Option to drive printer ports directly (faster); see Printer
  9875.       Parameters (p. 114)
  9876.       Option to change printer end of line control chars; see Printer
  9877.       Parameters (p. 114)
  9878.  
  9879.     Support for XGA video adapter
  9880.     Support for Targa+ video adapter
  9881.     16 color VGA mode enhancements:
  9882.       Now use the first 16 colors of .map files to be more predictable
  9883.       Palette editor now works with these modes
  9884.       Color cycling now works properly with these modes Targa video
  9885.     adapter fixes; Fractint now uses (and requires) the "targa"
  9886.       and "targaset" environment variables for Targa systems
  9887.     "vesadetect=no" parameter to bypass use of VESA video driver; try
  9888.       this if you encounter video problems with a VESA driver Upgraded
  9889.     video adapter detect and handling from John Bridges; autodetect
  9890.       added for NCR, Trident 8900, Tseng 4000, Genoa (this code is from a
  9891.       beta release of VGAKIT, we're not sure it all works yet)
  9892.  
  9893.     Zoom box is included in saved/printed images (but, is not recognized
  9894.       as anything special when such an image is restored)
  9895.  
  9896.     The colors numbers reserved by the palette editor are now selectable
  9897.       with the new <v> palette editing mode command
  9898.  
  9899.     Option to use IIT floating point chip's special matrix arithmetic for
  9900.       faster 3D transforms; see "fpu=" in Startup Parameters (p. 101)
  9901.  
  9902.     Disk video cache increased to 64k; disk video does less seeking when
  9903.       running to real disk
  9904.     Faster floating point code for 287 and higher fpus, for types mandel,
  9905.       julia, barnsleyj1/m1/j2/m2, lambda, manowar, from Chuck Ebbert
  9906.  
  9907.                       Fractint Version 19.2                       Page 182
  9908.  
  9909.     "filename=.xxx" can be used to set default <r> function file mask
  9910.  
  9911.     Selection of type formula or lsys now goes directly to entry selection
  9912.       (file selection step is now skipped); to change to a different file,
  9913.       use <F6> from the entry selection screen
  9914.  
  9915.     Three new values have been added to the textcolors= parameter; if you
  9916.       use this parameter you should update it by inserting values for the
  9917.       new 6th, 7th, 9th, and 13th positions; see "textcolors=" in Color
  9918.       Parameters (p. 106)
  9919.  
  9920.     The formula type's imag() function has changed to return the result as
  9921.       a real number
  9922.  
  9923.     Fractal type-specific parameters (entered after selecting a new
  9924.       fractal type with <T>) now restart at their default values each time
  9925.       you select a new fractal type
  9926.  
  9927.     Floating point input fields can now be entered in scientific notation
  9928.       (e.g.  11.234e-20). Entering the letters "e" and "p" in the first
  9929.       column causes the numbers e=2.71828... and pi=3.14159... to be
  9930.       entered.
  9931.  
  9932.     New option "orbitsave=yes" to create files for Acrospin for some types
  9933.       (see Barnsley IFS Fractals (p. 43), Orbit Fractals (p. 50),
  9934.       Acrospin (p. 171))
  9935.  
  9936.     Bug fixes:
  9937.       Problem with Hercules adapter auto-detection repaired.
  9938.       Problems with VESA video adapters repaired (we're not sure we've got
  9939.         them all yet...)
  9940.       3D transforms fixed to work at high resolutions (> 1000 dots).
  9941.       3D parameters no longer clobbered when restoring non-3D images.
  9942.       L-Systems fixed to not crash when order too high for available
  9943.       memory.
  9944.       PostScript EPS file fixes.
  9945.       Bad leftmost pixels with floating point at 2048 dot resolution
  9946.       fixed.
  9947.       3D transforms fixed to use current <x> screen float/integer setting.
  9948.       Restore of images using inversion fixed.
  9949.       Error in "cos" function (used with "fn" type fractals) fixed; prior
  9950.         incorrect function still available as "cosxx" for compatibility
  9951.  
  9952.     Old 3D=nn/nn/nn/... form of 3D transform parameters no longer
  9953.     supported
  9954.  
  9955.     Fractint source code now Microsoft C6.00A compatible.
  9956.  
  9957.   Version 15.11, 3/91, companion to Fractal Creations, not for general
  9958.   release
  9959.  
  9960.     Autokey feature, IIT fpu support, and some bug fixes publicly released
  9961.     in version 16.
  9962.  
  9963.                       Fractint Version 19.2                       Page 183
  9964.  
  9965.   Version 15 and 15.1, 12/90
  9966.  
  9967.     New user interface! Enjoy! Some key assignments have changed and some
  9968.       have been removed.
  9969.     New palette editing from Ethan Nagel.
  9970.     Reduced memory requirements - Fractint now uses overlays and will run
  9971.       on a 512K machine.
  9972.     New <v>iew command: use to get small window for fast preview, or to
  9973.       setup an image which will eventually be rendered on hard copy with
  9974.       different aspect ratio
  9975.     L-System fractal type from Adrian Mariano
  9976.     Postscript printer support from Scott Taylor
  9977.     Better Tandy video support and faster CGA video from Joseph A Albrecht
  9978.     16 bit continuous potential files have changed considerably;  see the
  9979.       Continuous Potential section for details.  Continuous potential is
  9980.       now resumable.
  9981.     Mandelbrot calculation is faster again (thanks to Mike Gelvin) -
  9982.       double speed in 8086 32 bit case
  9983.     Compressed log palette and sqrt palette from Chuck Ebbert
  9984.     Calculation automatically resumes whenever current image is resumable
  9985.       and is not paused for a visible reason.
  9986.     Auto increment of savename changed to be more predictable
  9987.     New video modes:
  9988.       trident 1024x768x256 mode
  9989.       320x480x256 tweak mode (good for reduced 640x480 viewing)
  9990.       changed NEC GB-1, hopefully it works now
  9991.     Integer mandelbrot and julia now work with periodicitycheck
  9992.     Initial zoombox color auto-picked for better contrast (usually)
  9993.     New adapter=cga|ega|mcga|vga for systems having trouble with auto-
  9994.     detect
  9995.     New textsafe=no|yes for systems having trouble with garbled text mode
  9996.     <r> and <3> commands now present list of video modes to pick from; <r>
  9997.       can reduce a non-standard or unviewable image size.
  9998.     Diffusion fractal type is now resumable after interrupt/save
  9999.     Exitmode=n parameter, sets video mode to n when exiting from fractint
  10000.     When savetime is used with 1 and 2 pass and solid guessing, saves are
  10001.       deferred till the beginning of a new row, so that no calculation
  10002.       time is lost.
  10003.     3d photographer's mode now allows the first image to be saved to disk
  10004.     textcolors=mono|12/34/56/... -- allows setting user interface colors
  10005.     Code (again!) compilable under TC++ (we think!)
  10006.     .TIW files (from v9.3) are no longer supported as input to 3D
  10007.       transformations
  10008.     bug fixes:
  10009.       multiple restores (msc 6.0, fixed in 14.0r)
  10010.       repeating 3d loads problem; slow 3d loads of images with float=yes
  10011.       map= is now a real substitute for default colors
  10012.       starfield and julibrot no longer cause permanent color map
  10013.       replacement
  10014.       starfield parameters bug fix - if you couldn't get the starfield
  10015.       parameters to do anything interesting before, try again with this
  10016.       release
  10017.       Newton and newtbasin orbit display fixed
  10018.  
  10019.                       Fractint Version 19.2                       Page 184
  10020.  
  10021.    Version 15.1:
  10022.  
  10023.     Fixed startup and text screen problems on systems with VESA compliant
  10024.       video adapters.
  10025.     New textsafe=save|bios options.
  10026.     Fixes for EGA with monochrome monitor, and for Hercules Graphics Card.
  10027.       Both should now be auto-detected and operate correctly in text
  10028.       modes.  Options adapter=egamono and adapter=hgc added.
  10029.     Fixed color L-Systems to not use color 0 (black).
  10030.     PostScript printing fix.
  10031.  
  10032.   Version 14, 8/90
  10033.  
  10034.     LAST MINUTE NEWS FLASH!
  10035.       CompuServe announces the GIF89a on August 1, 1990, and Fractint
  10036.       supports it on August 2! GIF files can now contain fractal
  10037.       information!  Fractint now saves its files in the new GIF89a format
  10038.       by default, and uses .GIF rather than .FRA as a default filetype.
  10039.       Note that Fractint still *looks* for a .FRA file on file restores if
  10040.       it can't find a .GIF file, and can be coerced into using the old
  10041.       GIF87a format with the new 'gif87a=yes' command-line option.
  10042.  
  10043.     Pieter Branderhorst mounted a major campaign to get his name in
  10044.     lights:
  10045.     Mouse interface:  Diagonals, faster movement, improved feel. Mouse
  10046.       button assignments have changed - see the online help.
  10047.     Zoom box enhancements:  The zoom box can be rotated, stretched,
  10048.       skewed, and panned partially offscreen.  See "More Zoom Box
  10049.       Commands".
  10050.     FINALLY!! You asked for it and we (eventually, by talking Pieter into
  10051.       it [actually he grabbed it]) did it!  Images can be saved before
  10052.       completion, for a subsequent restore and continue.  See
  10053.       "Interrupting and Resuming" and "Batch Mode".
  10054.     Off-center symmetry:  Fractint now takes advantage of x or y axis
  10055.       symmetry anywhere on the screen to reduce drawing time.
  10056.     Panning:  If you move an image up, down, left, or right, and don't
  10057.       change anything else, only the new edges are calculated.
  10058.     Disk-video caching - it is now possible, reasonable even, to do most
  10059.       things with disk video, including solid guessing, 3d, and plasma.
  10060.     Logarithmic palette changed to use all colors.  It now matches regular
  10061.       palette except near the "lake".  "logmap=old" gets the old way.
  10062.     New "savetime=nnn" parameter to save checkpoints during long
  10063.     calculations.
  10064.     Calculation time is shown in <Tab> display.
  10065.  
  10066.     Kevin C Allen    Finite Attractor, Bifurcation Engine, Magnetic
  10067.     fractals...
  10068.     Made Bifurcation/Verhulst into a generalized Fractal Engine (like
  10069.       StandardFractal, but for Bifurcation types), and implemented
  10070.       periodicity checking for Bifurcation types to speed them up.
  10071.     Added Integer version of Verhulst Bifurcation (lots faster now).
  10072.       Integer is the default.  The Floating-Point toggle works, too.
  10073.     Added NEW Fractal types BIFLAMBDA, BIF+SINPI, and BIF=SINPI. These are
  10074.       Bifurcation types that make use of the new Engine. Floating-
  10075.       point/Integer toggle is available for BIFLAMBDA. The SINPI types are
  10076.       Floating-Point only, at this time.
  10077.  
  10078.                       Fractint Version 19.2                       Page 185
  10079.  
  10080.     Corrected the generation of the MandelLambda Set.  Sorry, but it's
  10081.       always been wrong (up to v 12, at least).  Ask Mandelbrot !
  10082.     Added NEW Fractal types MAGNET1M, MAGNET1J, MAGNET2M, MAGNET2J from
  10083.       "The Beauty of Fractals".  Floating-Point only, so far, but what do
  10084.       you expect with THESE formulae ?!
  10085.     Added new symmetry types XAXIS NOIMAG and XAXIS NOREAL, required by
  10086.       the new MAGNETic Fractal types.
  10087.     Added Finite Attractor Bailout (FAB) logic to detect when iterations
  10088.       are approaching a known finite attractor. This is required by the
  10089.       new MAGNETic Fractal types.
  10090.     Added Finite Attractor Detection (FAD) logic which can be used by
  10091.       *SOME* Julia types prior to generating an image, to test for finite
  10092.       attractors, and find their values, for use by FAB logic. Can be used
  10093.       by the new MAGNETic Fractal Types, Lambda Sets, and some other Julia
  10094.       types too.
  10095.  
  10096.     Mike Burkey sent us new tweaked video modes:
  10097.       VGA     - 400x600x256   376x564x256   400x564x256
  10098.       ATI VGA - 832x612x256 New HP Paintjet support from Chris Martin
  10099.     New "FUNCTION=" command to allow substition of different
  10100.       transcendental functions for variables in types (allows one type
  10101.       with four of these variables to represent 7*7*7*7 different types!
  10102.     ALL KINDS of new fractal types, some using "FUNCTION=": fn(z*z),
  10103.       fn*fn, fn*z+z, fn+fn, sqr(1/fn), sqr(fn), spider, tetrate, and
  10104.       Manowar. Most of these are generalizations of formula fractal types
  10105.       contributed by Scott Taylor and Lee Skinner.
  10106.     Distance Estimator logic can now be applied to many fractal types
  10107.       using distest= option. The types "demm" and "demj" have been
  10108.       replaced by "type=mandel distest=nnn" and "type=julia distest=nnn"
  10109.     Added extended memory support for diskvideo thanks to Paul Varner
  10110.     Added support for "center and magnification" format for corners.
  10111.     Color 0 is no longer generated except when specifically requested with
  10112.       inside= or outside=.
  10113.     Formula name is now included in <Tab> display and in <S>aved images.
  10114.     Bug fixes - formula type and diskvideo, batch file outside=-1 problem.
  10115.     Now you can produce your favorite fractal terrains in full color
  10116.       instead of boring old monochrome! Use the fullcolor option in 3d!
  10117.       Along with a few new 3D options.
  10118.     New "INITORBIT=" command to allow alternate Mandelbrot set orbit
  10119.       initialization.
  10120.  
  10121.  
  10122.   Version 13.0, 5/90
  10123.  
  10124.     F1 was made the help key.
  10125.       Use F1 for help
  10126.       Use F9 for EGA 320x200x16 video mode
  10127.       Use CF4 for EGA 640x200x16 mode (if anybody uses that mode)
  10128.     Super-Solid-guessing (three or more passes) from Pieter Branderhorst
  10129.       (replaces the old solid-guessing mode)
  10130.     Boundary Tracing option from David Guenther ("fractint passes=btm", or
  10131.       use the new 'x' options screen)
  10132.     "outside=nnn" option sets all points not "inside" the fractal to color
  10133.       "nnn" (and generates a two-color image).
  10134.     'x' option from the main menu brings up a full-screen menu of many
  10135.       popular options and toggle switches
  10136.  
  10137.                       Fractint Version 19.2                       Page 186
  10138.  
  10139.     "Speed Key" feature for fractal type selection (either use the cursor
  10140.       keys for point-and-shoot, or just start typing the name of your
  10141.       favorite fractal type)
  10142.     "Attractor" fractals (Henon, Rossler, Pickover, Gingerbread)
  10143.     Diffusion fractal type by Adrian Mariano
  10144.     "type=formula" formulas from Scott Taylor and Lee H. Skinner.
  10145.     "sound=" options for attractor fractals.  Sound=x  plays speaker tones
  10146.       according to the 'x' attractor value  Sound=y  plays speaker tones
  10147.       according to the 'y' attractor value.  Sound=z  plays speaker tones
  10148.       according to the 'z' attractor value  (These options are best
  10149.       invoked with the floating-point algorithm flag set.)
  10150.     "hertz=" option for adjusting the "sound=x/y/z" output.
  10151.     Printer support for color printers (printer=color) from Kurt Sowa
  10152.     Trident 4000 and Oak Technologies SuperVGA support from John Bridges
  10153.     Improved 8514/A support (the zoom-box keeps up with the cursor keys
  10154.     now!)
  10155.     Tandy 1000 640x200x16 mode from Brian Corbino (which does not, as yet,
  10156.       work with the F1(help) and TAB functions)
  10157.     The Julibrot fractal type and the Starmap option now automatically
  10158.       verify that they have been selected with a 256-color palette, and
  10159.       search for, and use, the appropriate GLASSESn.MAP or ALTERN.MAP
  10160.       palette map when invoked.  *You* were supposed to be doing that
  10161.       manually all along, but *you* probably never read the docs, huh?
  10162.     Bug Fixes:
  10163.       TAB key now works after R(estore) commands
  10164.       PS/2 Model 30 (MCGA) adapters should be able to select 320x200x256
  10165.         mode again (we think)
  10166.       Everex video adapters should work with the Autodetect modes again
  10167.         (we think)
  10168.  
  10169.  
  10170.   Version 12.0, 3/90
  10171.  
  10172.     New SuperVGA Autodetecting and VESA Video modes (you tell us the
  10173.       resolution you want, and we'll figure out how to do it)
  10174.     New Full-Screen Entry for most prompting
  10175.     New Fractal formula interpreter ('type=formula') - roll your own
  10176.       fractals without using a "C" compiler!
  10177.     New 'Julibrot' fractal type
  10178.     Added floating point option to all remaining fractal types.
  10179.     Real (funny glasses) 3D - Now with "real-time" lorenz3D!!
  10180.     Non-Destructive <TAB> - Check out what your fractal parameters are
  10181.       without stopping the generation of a fractal image
  10182.     New Cross-Hair mode for changing individual palette colors (VGA only)
  10183.     Zooming beyond the limits of Integer algorithms (with automatic
  10184.       switchover to a floating-point algorithm when you zoom in "too far")
  10185.     New 'inside=bof60', 'inside=bof61' ("Beauty of Fractals, Page nn")
  10186.     options
  10187.     New starmap ('a' - for astrology? astronomy?) transformation option
  10188.     Restrictions on the options available when using Expanded Memory
  10189.       "Disk/RAM" video mode have been removed
  10190.     And a lot of other nice little clean-up features that we've already
  10191.       forgotten that we've added...
  10192.     Added capability to create 3D projection images (just barely) for
  10193.       people with 2 or 4 color video boards.
  10194.  
  10195.                       Fractint Version 19.2                       Page 187
  10196.  
  10197.   Version 11.0, 1/90
  10198.  
  10199.     More fractal types
  10200.       mandelsinh/lambdasinh        mandelcosh/lambdacosh
  10201.       mansinzsqrd/julsinzsqrd      mansinexp/julsinexp
  10202.       manzzprw/julzzpwr            manzpower/julzpower
  10203.       lorenz (from Rob Beyer)      lorenz3d
  10204.       complexnewton                complexbasin
  10205.       dynamic                      popcorn
  10206.     Most fractal types given an integer and a floating point algorithm.
  10207.       "Float=yes" option now determines whether integer or floating-point
  10208.       algorithms are used for most fractal types.  "F" command toggles the
  10209.       use of floating-point algorithms, flagged in the <Tab> status
  10210.       display
  10211.     8/16/32/../256-Way decomposition option (from Richard Finegold)
  10212.     "Biomorph=", "bailout=", "symmetry="  and "askvideo=" options
  10213.     "T(ransform)" option in the IFS editor lets you select 3D options
  10214.       (used with the Lorenz3D fractal type)
  10215.     The "T(ype)" command uses a new "Point-and-Shoot" method of selecting
  10216.       fractal types rather than prompting you for a type name
  10217.     Bug fixes to continuous-potential algorithm on integer fractals, GIF
  10218.       encoder, and IFS editor
  10219.  
  10220.  
  10221.   Version 10.0, 11/89
  10222.  
  10223.     Barnsley IFS type (Rob Beyer)
  10224.     Barnsley IFS3D type
  10225.     MandelSine/Cos/Exp type
  10226.     MandelLambda/MarksLambda/Unity type
  10227.     BarnsleyM1/J1/M2/J2/M3/J3 type
  10228.     Mandel4/Julia4 type
  10229.     Sierpinski gasket type
  10230.     Demm/Demj and bifurcation types (Phil Wilson), "test" is "mandel"
  10231.     again
  10232.     <I>nversion command for most fractal types
  10233.     <Q>uaternary decomposition toggle and "DECOMP=" argument
  10234.     <E>ditor for Barnsley IFS parameters
  10235.     Command-line options for 3D parameters
  10236.     Spherical 3D calculations 5x faster
  10237.     3D now clips properly to screen edges and works at extreme perspective
  10238.     "RSEED=" argument for reproducible plasma clouds
  10239.     Faster plasma clouds (by 40% on a 386)
  10240.     Sensitivity to "continuous potential" algorithm for all types except
  10241.       plasma and IFS
  10242.     Palette-map <S>ave and Restore (<M>) commands
  10243.     <L>ogarithmic and <N>ormal palette-mapping commands and arguments
  10244.     Maxiter increased to 32,000 to support log palette maps
  10245.     .MAP and .IFS files can now reside anywhere along the DOS path
  10246.     Direct-video support for Hercules adapters (Dean Souleles)
  10247.     Tandy 1000 160x200x16 mode (Tom Price)
  10248.     320x400x256 register-compatible-VGA "tweaked" mode
  10249.     ATI VGA Wonder 1024x768x16 direct-video mode (Mark Peterson)
  10250.     1024x768x16 direct-video mode for all supported chipsets
  10251.     Tseng 640x400x256 mode
  10252.     "Roll-your-own" video mode 19
  10253.  
  10254.                       Fractint Version 19.2                       Page 188
  10255.  
  10256.     New video-table "hot-keys" eliminate need for enhanced keyboard to
  10257.       access later entries
  10258.  
  10259.  
  10260.   Version 9.3, 8/89
  10261.  
  10262.     <P>rint command and "PRINTER=" argument (Matt Saucier)
  10263.     8514/A video modes (Kyle Powell)
  10264.     SSTOOLS.INI sensitivity and '@THISFILE' argument
  10265.     Continuous-potential algorithm for Mandelbrot/Julia sets
  10266.     Light source 3D option for all fractal types
  10267.     "Distance estimator" M/J method (Phil Wilson) implemented as "test"
  10268.     type
  10269.     LambdaCosine and LambdaExponent types
  10270.     Color cycling mode for 640x350x16 EGA adapters
  10271.     Plasma clouds for 16-color and 4-color video modes
  10272.     Improved TARGA support (Joe McLain)
  10273.     CGA modes now use direct-video read/writes
  10274.     Tandy 1000 320x200x16 and 640x200x4 modes (Tom Price)
  10275.     TRIDENT chip-set super-VGA video modes (Lew Ramsey)
  10276.     Direct-access video modes for TRIDENT, Chips & Technologies, and ATI
  10277.       VGA WONDER adapters (John Bridges). and, unlike version 9.1, they
  10278.       WORK in version 9.3!)
  10279.     "zoom-out" (<Ctrl><Enter>) command
  10280.     <D>os command for shelling out
  10281.     2/4/16-color Disk/RAM video mode capability and 2-color video modes
  10282.       supporting full-page printer graphics
  10283.     "INSIDE=-1" option (treated dynamically as "INSIDE=maxiter")
  10284.     Improved <H>elp and sound routines (even a "SOUND=off" argument)
  10285.     Turbo-C and TASM compatibility (really!  Would we lie to you?)
  10286.  
  10287.  
  10288.   Version 8.1, 6/89
  10289.  
  10290.     <3>D restore-from-disk and 3D <O>verlay commands, "3D=" argument
  10291.     Fast Newton algorithm including inversion option (Lee Crocker)
  10292.     16-bit Mandelbrot/Julia logic for 386-class speed with non-386 PCs on
  10293.       "large" images (Mark Peterson)
  10294.     Restore now loads .GIF files (as plasma clouds)
  10295.     TARGA video modes and color-map file options (Joe McLain)
  10296.     30 new color-cycling palette options (<Shft><F1> to <Alt><F10>)
  10297.     "Disk-video, RAM-video, EMS-video" modes
  10298.     Lambda sets now use integer math (with 80386 speedups)
  10299.     "WARN=yes" argument to prevent over-writing old .GIF files
  10300.  
  10301.  
  10302.   Version 7.0, 4/89
  10303.  
  10304.     Restore from disk (from prior save-to-disk using v. 7.0 or later)
  10305.     New types: Newton, Lambda, Mandelfp, Juliafp, Plasma, Lambdasine
  10306.     Many new color-cycling options (for VGA adapters only)
  10307.     New periodicity logic (Mark Peterson)
  10308.     Initial displays recognize (and use) symmetry
  10309.     Solid-guessing option (now the default)
  10310.     Context-sensitive <H>elp
  10311.     Customizable video mode configuration file (FRACTINT.CFG)
  10312.  
  10313.                       Fractint Version 19.2                       Page 189
  10314.  
  10315.     "Batch mode" option
  10316.     Improved super-VGA support (with direct video read/writes)
  10317.     Non-standard 360 x 480 x 256 color mode on a STANDARD IBM VGA!
  10318.  
  10319.  
  10320.   Version 6.0, 2/89
  10321.  
  10322.     32-bit integer math emulated for non-386 processors; FRACT386 renamed
  10323.       FRACTINT
  10324.     More video modes
  10325.  
  10326.  
  10327.   Version 5.1, 1/89
  10328.  
  10329.     Save to disk
  10330.     New! Improved! (and Incompatible!) optional arguments format
  10331.     "Correct" initial image aspect ratio
  10332.     More video modes
  10333.  
  10334.  
  10335.   Version 4.0, 12/88
  10336.  
  10337.     Mouse support (Mike Kaufman)
  10338.     Dynamic iteration limits
  10339.     Color cycling
  10340.     Dual-pass mode
  10341.     More video modes, including "tweaked" modes for IBM VGA and register-
  10342.       compatible adapters
  10343.  
  10344.  
  10345.   Version 3.1, 11/88
  10346.  
  10347.     Julia sets
  10348.  
  10349.  
  10350.   Version 2.1, 10/23/88 (the "debut" on CIS)
  10351.  
  10352.     Video table
  10353.     CPU type detector
  10354.  
  10355.  
  10356.   Version 2.0, 10/10/88
  10357.  
  10358.     Zoom and pan
  10359.  
  10360.  
  10361.   Version 1.0, 9/88
  10362.  
  10363.     The original, blindingly fast, 386-specific 32-bit integer algorithm
  10364.  
  10365.                       Fractint Version 19.2                       Page 190
  10366.  
  10367.  Appendix H Version13 to Version 14 Type Mapping
  10368.  
  10369.   A number of types in Fractint version 13 and earlier were generalized in
  10370.   version 14. We added a "backward compatibility" hook that (hopefully)
  10371.   automatically translates these to the new form when the old files are
  10372.   read. Files may be converted via:
  10373.  
  10374.      FRACTINT OLDFILE.FRA SAVENAME=NEWFILE.GIF BATCH=YES
  10375.  
  10376.   In a few cases the biomorph flag was incorrectly set in older files.  In
  10377.   that case, add "biomorph=no" to the command line.
  10378.  
  10379.   This procedure can also be used to convert any *.fra file to the new
  10380.   GIF89a spec, which now allows storage of fractal information.
  10381.  
  10382.  
  10383.   TYPES CHANGED FROM VERSION 13 -
  10384.  
  10385.  
  10386.   V13 NAME                V14 NAME + PARAMETERS
  10387.   --------                --------------------------------------
  10388.  
  10389.   LOGMAP=YES              LOGMAP=OLD   for identical Logmap type
  10390.  
  10391.   DEMJ                    JULIA DISTEST=nnn
  10392.  
  10393.   DEMM                    MANDEL DISTEST=nnn
  10394.  
  10395.                           Note: DISTEST also available on many other types
  10396.  
  10397.   MANSINEXP               MANFN+EXP FUNCTION=SIN
  10398.  
  10399.                           Note: New functions for this type are
  10400.                                 cos sinh cosh exp log sqr
  10401.  
  10402.   JULSINEXP               JULFN+EXP FUNCTION=SIN
  10403.  
  10404.                           Note: New functions for this type are
  10405.                                 cos sinh cosh exp log sqr
  10406.  
  10407.   MANSINZSQRD             MANFN+ZSQRD FUNCTION=SQR/SIN
  10408.  
  10409.                           Note: New functions for this type are
  10410.                                 cos sinh cosh exp log sqr
  10411.  
  10412.   JULSINZSQRD             JULFN+ZSQRD FUNCTION=SQR/SIN
  10413.  
  10414.                           Note: New functions for this type are
  10415.                                 cos sinh cosh exp log sqr
  10416.  
  10417.   LAMBDACOS               LAMBDAFN FUNCTION=COS
  10418.  
  10419.   LAMBDACOSH              LAMBDAFN FUNCTION=COSH
  10420.  
  10421.                       Fractint Version 19.2                       Page 191
  10422.  
  10423.   LAMBDAEXP               LAMBDAFN FUNCTION=EXP
  10424.  
  10425.   LAMBDASINE              LAMBDAFN FUNCTION=SIN
  10426.  
  10427.   LAMBDASINH              LAMBDAFN FUNCTION=SINH
  10428.  
  10429.                           Note: New functions for this type are
  10430.                                 log sqr
  10431.  
  10432.   MANDELCOS               MANDELFN FUNCTION=COS
  10433.  
  10434.   MANDELCOSH              MANDELFN FUNCTION=COSH
  10435.  
  10436.   MANDELEXP               MANDELFN FUNCTION=EXP
  10437.  
  10438.   MANDELSINE              MANDELFN FUNCTION=SIN
  10439.  
  10440.   MANDELSINH              MANDELFN FUNCTION=SINH
  10441.  
  10442.                           Note: New functions for this type are
  10443.                                 log sqr
  10444.  
  10445.   MANDELLAMBDA            MANDELLAMBDA INITORBIT=PIXEL
  10446.  
  10447.   POPCORN SYMMETRY=NONE   POPCORNJUL
  10448.  
  10449.   -------------------------------------------------------------
  10450.  
  10451.   Formulas from FRACTINT.FRM in version 13
  10452.  
  10453.   MANDELGLASS             MANDELLAMBDA INITORBIT=.5/0
  10454.  
  10455.   INVMANDEL               V13 divide bug may cause some image differences.
  10456.  
  10457.   NEWTON4                 V13 divide bug may cause some image differences.
  10458.  
  10459.   SPIDER                  V13 divide bug may cause some image differences.
  10460.  
  10461.   MANDELSINE              MANDELFN FUNCTION=SIN BAILOUT=50
  10462.  
  10463.   MANDELCOSINE            MANDELFN FUNCTION=COS BAILOUT=50
  10464.  
  10465.   MANDELHYPSINE           MANDELFN FUNCTION=SINH BAILOUT=50
  10466.  
  10467.   MANDELHYPCOSINE         MANDELFN FUNCTION=COSH BAILOUT=50
  10468.  
  10469.   SCOTTSIN PARAMS=nnn     FN+FN FUNCTION=SIN/SQR BAILOUT=nnn+3
  10470.  
  10471.   SCOTTSINH PARAMS=nnn    FN+FN FUNCTION=SINH/SQR BAILOUT=nnn+3
  10472.  
  10473.   SCOTTCOS PARAMS=nnn     FN+FN FUNCTION=COS/SQR BAILOUT=nnn+3
  10474.  
  10475.   SCOTTCOSH PARAMS=nnn    FN+FN FUNCTION=COSH/SQR BAILOUT=nnn+3
  10476.  
  10477.                       Fractint Version 19.2                       Page 192
  10478.  
  10479.   SCOTTLPC PARAMS=nnn     FN+FN FUNCTION=LOG/COS BAILOUT=nnn+3
  10480.  
  10481.   SCOTTLPS PARAMS=nnn     FN+FN FUNCTION=LOG/SIN BAILOUT=nnn+3
  10482.                           Note: New functions for this type are
  10483.                           sin/sin sin/cos sin/sinh sin/cosh sin/exp
  10484.                           cos/cos cos/sinh cos/cosh cos/exp
  10485.                           sinh/sinh sinh/cosh sinh/exp sinh/log
  10486.                           cosh/cosh cosh/exp cosh/log
  10487.                           exp/exp exp/log exp/sqr log/log log/sqr sqr/sqr
  10488.  
  10489.   SCOTTSZSA PARAMS=nnn    FN(Z*Z) FUNCTION=SIN BAILOUT=nnn+3
  10490.  
  10491.   SCOTTCZSA PARAMS=nnn    FN(Z*Z) FUNCTION=COS BAILOUT=nnn+3
  10492.  
  10493.                           Note: New functions for this type are
  10494.                           sinh cosh exp log sqr
  10495.  
  10496.   SCOTTZSZZ PARAMS=nnn    FN*Z+Z FUNCTION=SIN BAILOUT=nnn+3
  10497.  
  10498.   SCOTTZCZZ PARAMS=nnn    FN*Z+Z FUNCTION=COS BAILOUT=nnn+3
  10499.  
  10500.                           Note: New functions for this type are
  10501.                           sinh cosh exp log sqr
  10502.  
  10503.   SCOTTSZSB PARAMS=nnn    FN*FN FUNCTION=SIN/SIN BAILOUT=nnn+3
  10504.  
  10505.   SCOTTCZSB PARAMS=nnn    FN*FN FUNCTION=COS/COS BAILOUT=nnn+3
  10506.  
  10507.   SCOTTLTS PARAMS=nnn     FN*FN FUNCTION=LOG/SIN BAILOUT=nnn+3
  10508.  
  10509.   SCOTTLTC PARAMS=nnn     FN*FN FUNCTION=LOG/COS BAILOUT=nnn+3
  10510.  
  10511.                           Note: New functions for this type are
  10512.                           sin/cos sin/sinh sin/cosh sin/exp sin/sqr
  10513.                           cos/sinh cos/cosh cos/exp cos/sqr
  10514.                           sinh/sinh sinh/cosh sinh/exp sinh/log sinh/sqr
  10515.                           cosh/cosh cosh/exp cosh/log cosh/sqr
  10516.                           exp/exp exp/log exp/sqr log/log log/sqr sqr/sqr
  10517.  
  10518.   SCOTTSIC PARAMS=nnn     SQR(1/FN) FUNCTION=COS BAILOUT=nnn+3
  10519.  
  10520.   SCOTTSIS PARAMS=nnn     SQR(1/FN) FUNCTION=SIN BAILOUT=nnn+3
  10521.  
  10522.   TETRATE PARAMS=nnn      TETRATE BAILOUT=nnn+3
  10523.  
  10524.                           Note: New function type sqr(1/fn) with
  10525.                                 sin cos sinh cosh exp log sqr
  10526.  
  10527.                           Note: New function type sqr(fn) with
  10528.                                 sin cos sinh cosh exp log sqr
  10529.